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 to view this page for the latest version.


Parameter run_test allows to filter which test units to execute during testing. The Unit Test Framework supports both "selection filters", which allow to select which test units to enable from the set of available test units, and "disabler filters", which allow to disable some test units. The Unit Test Framework also supports enabling/disabling test units at compile time. These settings identify the default set of test units to run. Parameter run_test is used to change this default. This parameter is repeatable, so you can specify more than one filter if necessary.

More details about practical application of this parameter resides in test unit filtering section.

Acceptable values

String value representing single filter. The following grammar productions describe the syntax of filters:

filter        ::= relative_spec? test_set
relative_spec ::= '+' | '!'
test_set      ::= label | path
label         ::= '@' identifier
path          ::= (suite '/')? patern_list
patern_list   ::= (pattern ',')* pattern
suite         ::= (pattern '/')* pattern
pattern       ::= '*'? identifier '*'?

Regarding the meaning of these values see here.

Command line syntax
Environment variable