...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Boost.Build's msvc-stlport toolset supports the Microsoft Visual C++ command-line tools, using the STLport standard library implementation on Microsoft Windows. It is designed to allow you to build and test with multiple installed versions of STLPort, so that objects build in each configuration will be built into separate directories.
msvc
toolset responds to the following
variables, which can be set in the environment or configured on the jam
command-line using -sVARIABLE_NAME=
value. It is
an extension of the msvc toolset and
therefore responds to all of the MSVC configuration variables in addition to
those listed below.
In the table below, version corresponds to an STLPort version
number, e.g. "4.5.3
".
Variable Name | Semantics | Default | Notes |
---|---|---|---|
STLPORT_PATH |
A directory containing at least one subdirectory of the form
/STLPort- version where an STLPort installation can
be found. |
empty | Allows easy configuration for an installation where several STLPort versions are installed under a single directory. |
STLPORT_ version_PATH |
The directory where the specific STLPort version
installation can be found, in case there is no central location
appropriate for STLPORT_PATH , above, or a particular
version's installation is not located in the usual place. |
empty | Allows configuration of a specific STLPort installation. |
STLPORT_VERSION |
The version of STLPort in use by default. | 4.5.3 |
Other values can be selected in parallel setting the build property
<stlport-version> to values from the list of
$(STLPORT_VERSIONS) |
STLPORT_VERSIONS |
A space-separated list of alternate versions of STLport available on this machine. | 4.5 4.0 |
msvc-stlport
-specific features can be used in target build
requirements or in the BUILD
variable:
Feature | Values | Default | Semantics |
---|---|---|---|
stlport-iostream |
off on |
off |
Controls whether STLPort's own iostreams are in use. Though this
setting is off by default to save users from having to
build STLPort, we strongly recommend on instead. |
stlport-version |
$(STLPORT_VERSION) $(STLPORT_VERSIONS) (see
above) |
$(STLPORT_VERSION) |
Selects a version of STLPort for each target |
stlport-cstd-namespace |
std global |
std |
Controls whether or not names from the "C" library headers such as
<cstdlib> are imported into namespace std . |
Revised 14 May, 2002
Copyright © Dave Abrahams 2002.
Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at www.boost.org/LICENSE_1_0.txt)