Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for a snapshot of the master branch, built from commit 1ae620108f.
PrevUpHomeNext

HRF: Human readable log format

The human readable log format is designed to closely match an errors description produced by the Microsoft family of C++ compilers. This format allows jumping to the error location, if test module output is redirected into IDE output window. The rest of the log messages are designed to produce the most human friendly description of the events occurring in test module. This is a default format generated by test modules.

Here the list of events along with corresponding message and the condition that has to be satisfied for it to appear in the output.

Event

Condition

Output

On testing start

threshold != log_nothing

Running <total number of test cases> test case(s) ...

On testing start

threshold != log_nothing, show_build_info is set

Platform: $BOOST_PLATFORM
Compiler: $BOOST_COMPILER
STL     : $BOOST_STDLIB
Boost   : $BOOST_VERSION

On abnormal testing termination

threshold <= log_messages

Test is aborted

On test unit start

threshold <= log_test_units

Entering test <test unit type> <test unit name>

On test unit end

threshold <= log_test_units; testing time is reported only if elapsed time is more than 1 us.

Leaving test <test unit type> <test unit name>; testing time <value>

On skipped test unit

threshold <= log_test_units

Test <test unit type> <test unit name> is skipped

On uncaught C++ exception

threshold <= log_cpp_exception_errors. Checkpoint message is reported only if provided

unknown location(0): fatal error in <test case name>: <explanation> <last checkpoint location>: last checkpoint: <checkpoint message>

On resumable system error

threshold <= log_system_errors. Checkpoint message is reported only if provided

unknown location(0): fatal error in <test case name>: <explanation> <last checkpoint location>: last checkpoint: <checkpoint message>

On fatal system error

threshold <= log_fatal_errors. Checkpoint message is reported only if provided

unknown location(0): fatal error in <test case name>: <explanation> <last checkpoint location>: last checkpoint: <checkpoint message>

On passed test assertion

threshold <= log_successful_tests

<assertion location>: info: check<assertion expression> passed

On failed WARNING level test assertion

threshold <= log_warnings

<assertion location>: warning in <test case name>: condition <assertion description> is not satisfied

On failed CHECK level test assertion

threshold <= log_all_errors

<assertion location>: error in <test case name>: check <assertion description> failed

On failed REQUIRE level test assertion

threshold <= log_fatal_errors

<assertion location>: fatal error in <test case name>: critical check <assertion description> failed

On test log message

threshold <= log_messages

<Message content>

The level of details concerning the error message depends on the testing tool producing the log entry.


PrevUpHomeNext