BOOST_CHECKPOINT( message )

This tool is used to mark a test flow with a check points. The checkpoint can help to locate a source of a runtime exception.

The tool's only parameter is the message that get printed in case of any exceptions occurred before the end of test case or another call to BOOST_CHECKPOINT. In case if an exception does occur and checkpoint was set, the Test Log generates the message in a following format: last checkpoint: <checkpoint message>

Example

int test_main( int, char* [] ) {
    BOOST_CHECKPOINT( "Going to throw an exception" );
    throw "some error";

    return 0;
}

Output

Exception in test_main : C string:some error
test.cpp(2) : last checkpoint: Going to throw an exception