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>
int test_main( int, char* [] ) { BOOST_CHECKPOINT( "Going to throw an exception" ); throw "some error"; return 0; }
Exception in test_main : C string:some error
test.cpp(2) : last checkpoint: Going to throw an exception