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.

Test and Example Programs

Test Programs


A regression test application that gives the matching/searching algorithms a full workout. The presence of this program is your guarantee that the library will behave as claimed - at least as far as those items tested are concerned - if anyone spots anything that isn't being tested I'd be glad to hear about it.



Verifies that "bad" regular expressions don't cause the matcher to go into infinite loops, but to throw an exception instead.

Files: bad_expression_test.cpp.


Verifies that the matcher can't overrun the stack (no matter what the expression).

Files: recursion_test.cpp.


Verifies that the library meets all documented concepts (a compile only test).

Files: concept_check.cpp.


Test code for captures.

Files: captures_test.cpp.

Example programs


A simple grep implementation, run with the -h command line option to find out its usage.

Files: grep.cpp


A simple interactive expression matching application, the results of all matches are timed, allowing the programmer to optimize their regular expressions where performance is critical.

Files: regex_timer.cpp.

Code snippets

The snippets examples contain the code examples used in the documentation:

captures_example.cpp: Demonstrates the use of captures.

credit_card_example.cpp: Credit card number formatting code.

partial_regex_grep.cpp: Search example using partial matches.

partial_regex_match.cpp: regex_match example using partial matches.

regex_iterator_example.cpp: Iterating through a series of matches.

regex_match_example.cpp: ftp based regex_match example.

regex_merge_example.cpp: regex_merge example: converts a C++ file to syntax highlighted HTML.

regex_replace_example.cpp: regex_replace example: converts a C++ file to syntax highlighted HTML

regex_search_example.cpp: regex_search example: searches a cpp file for class definitions.

regex_token_iterator_eg_1.cpp: split a string into a series of tokens.

regex_token_iterator_eg_2.cpp: enumerate the linked URL's in a HTML file.

The following are deprecated:

regex_grep_example_1.cpp: regex_grep example 1: searches a cpp file for class definitions.

regex_grep_example_2.cpp: regex_grep example 2: searches a cpp file for class definitions, using a global callback function.

regex_grep_example_3.cpp: regex_grep example 2: searches a cpp file for class definitions, using a bound member function callback.

regex_grep_example_4.cpp: regex_grep example 2: searches a cpp file for class definitions, using a C++ Builder closure as a callback.

regex_split_example_1.cpp: regex_split example: split a string into tokens.

regex_split_example_2.cpp : regex_split example: spit out linked URL's.