SHTK_UNITTEST_SET_EXPECT_FAILURE(3)

NAME
shtk_unittest_set_expect_failure - Makes the test expect a failure

LIBRARY
shtk_import unittest

SYNOPSIS
shtk_unittest_set_expect_failure

DESCRIPTION
The shtk_unittest_set_expect_failure function changes the behavior of the test so that a failure indicates success and a pass indicates a failure.

Changing the expectation of the test to a failure is useful for test cases that exercise a known bug: while the bug is live, the test case will pass with a message describing the error encountered; however, when the bug is fixed, the test will start failing indicating that it needs to be revised.

shtk_unittest_set_expect_failure can only be called once during the execution of a test case and its effects cannot be reversed.

SEE ALSO
shtk(3), shtk_unittest(3)

HISTORY
shtk_unittest_set_expect_failure first appeared in shtk 1.6.