1 <?xml version=
"1.0" encoding=
"utf-8"?>
2 <!DOCTYPE library PUBLIC
"-//Boost//DTD BoostBook XML V1.0//EN"
3 "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
5 <!-- Copyright (c) 2002-2006 Pavol Droba.
6 Subject to the Boost Software License, Version 1.0.
7 (See accompanying file LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txt)
10 <section id=
"string_algo.env" last-revision=
"$Date$">
11 <title>Environment
</title>
15 The whole library is provided in headers. Regex variants of some algorithms,
16 however, are dependent on the
<libraryname>Boost.Regex
</libraryname> library. All such algorithms are
17 separated in
<headername>boost/algorithm/string_regex.hpp
</headername>.
18 If this header is used, the application must be linked with the
<libraryname>Boost.Regex
</libraryname>
24 <title>Examples
</title>
26 Examples showing the basic usage of the library can be found in the libs/algorithm/string/example
27 directory. There is a separate file for the each part of the library. Please follow the boost
28 build guidelines to build examples using the bjam. To successfully build regex examples
29 the
<libraryname>Boost.Regex
</libraryname> library is required.
36 A full set of test cases for the library is located in the libs/algorithm/string/test directory.
37 The test cases can be executed using the boost build system. For the tests of regular
38 expression variants of algorithms, the
<libraryname>Boost.Regex
</libraryname> library is required.
43 <title>Portability
</title>
45 The library has been successfully compiled and tested with the following compilers:
48 <listitem>Microsoft Visual C++
7.0</listitem>
49 <listitem>Microsoft Visual C++
7.1</listitem>
50 <listitem>GCC
3.2</listitem>
51 <listitem>GCC
3.3.1</listitem>
54 See
<ulink url=
"http://boost.sourceforge.net/regression-logs/">Boost regression tables
</ulink>
55 for additional info for a particular compiler.
58 There are known limitation on platforms not supporting partial template specialization.
59 Library depends on correctly implemented
<code>std::iterator_traits
</code> class.
60 If a standard library provided with compiler is broken, the String Algorithm Library
61 cannot function properly. Usually it implies that primitive pointer iterators are not
62 working with the library functions.