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