Boost C++ Libraries 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 an old version of boost. Click here for the latest Boost documentation.

Function run

boost::unit_test::framework::run — Initiates test execution.


// In header: <boost/test/framework.hpp>

void run(test_unit_id tu = INV_TEST_UNIT_ID, bool continue_test = true);


This function is used to start the test execution from a specific "root" test unit. If no root provided, test is started from master test suite. This second argument facilitates an ability of the test cases to start some other test units (primarily used internally for self testing).



true == continue test if it was already started, false == restart the test from scratch regardless


Optional id of the test unit or test unit itself from which the test is started. If absent, master test suite is used