Boost C++ 库

CXX

编译器的名称，例如 c++。

CXXFLAGS

要使用的编译器标志，例如 -O2。

LDFLAGS

要使用的链接器标志，例如 -L/mypath。

LIBS

要链接的任何库，例如 -lpthread。

BOOST_USER_CONFIG

当定义此宏时，它应该指向用户配置文件名，该文件将在任何 Boost 配置文件之前包含。未定义时，默认为 <boost/config/user.hpp>。

BOOST_COMPILER_CONFIG

当定义此宏时，它应该指向要使用的编译器配置文件名。定义此宏会排除编译器选择逻辑，并消除对包含该逻辑的头文件的依赖。例如，如果您使用的是 gcc，那么您可以将 BOOST_COMPILER_CONFIG 定义为 <boost/config/compiler/gcc.hpp>。

BOOST_STDLIB_CONFIG

当定义此宏时，它应该指向要使用的标准库配置文件名。定义此宏会排除标准库选择逻辑，并消除对包含该逻辑的头文件的依赖。例如，如果您使用的是 STLport，那么您可以将 BOOST_STDLIB_CONFIG 定义为 <boost/config/stdlib/stlport.hpp>。

BOOST_PLATFORM_CONFIG

当定义此宏时，它应该指向要使用的平台配置文件名。定义此宏会排除平台选择逻辑，并消除对包含该逻辑的头文件的依赖。例如，如果您在 Linux 上编译，那么您可以将 BOOST_PLATFORM_CONFIG 定义为 <boost/config/platform/linux.hpp>。

BOOST_NO_COMPILER_CONFIG

当定义此宏时，不会选择或包含任何编译器配置文件。当编译器完全符合标准，或者用户头文件（参见 BOOST_USER_CONFIG）已根据需要添加了任何选项（例如通过 autoconf 生成的 configure 脚本）时，请定义此宏。

BOOST_NO_STDLIB_CONFIG

当定义此宏时，不会选择或包含任何标准库配置文件。当标准库完全符合标准，或者用户头文件（参见 BOOST_USER_CONFIG）已根据需要添加了任何选项（例如通过 autoconf 生成的 configure 脚本）时，请定义此宏。

BOOST_NO_PLATFORM_CONFIG

当定义此宏时，不会选择或包含任何平台配置文件。当平台完全符合标准（且没有有用的额外功能），或者用户头文件（参见 BOOST_USER_CONFIG）已根据需要添加了任何选项（例如通过 autoconf 生成的 configure 脚本）时，请定义此宏。

BOOST_NO_CONFIG

等同于定义所有 BOOST_NO_COMPILER_CONFIG、BOOST_NO_STDLIB_CONFIG 和 BOOST_NO_PLATFORM_CONFIG。

BOOST_STRICT_CONFIG

对于比已知最新版本更新的编译器版本，默认行为是假设它们具有与已知最新版本相同的缺陷。通过设置此宏定义，那么比已知最新版本更新的编译器版本被假定为完全符合标准。这可能最适用于 Boost 开发人员或测试人员，以及那些想使用 Boost 测试 Beta 编译器版本的人。

BOOST_ASSERT_CONFIG

当设置此标志时，如果配置发现任何未知项，它将停止并显示 #error 而不是继续。Boost 回归测试人员应设置此宏定义，任何想要快速检查其平台是否支持 Boost 的人也应该设置。

BOOST_DISABLE_THREADS

当定义此宏时，将禁用线程支持，即使编译器在其当前翻译模式下支持多线程。

BOOST_DISABLE_WIN32

当定义此宏时，将禁用 Win32 特定 API 的使用，即使这些 API 可用。除非设置了 BOOST_HAS_PTHREADS，否则还会将 BOOST_DISABLE_THREADS 设置为已定义。当配置系统检测到编译器处于“严格模式”时，此选项可能会被自动设置。

BOOST_DISABLE_ABI_HEADERS

阻止 boost 头文件包含任何通常控制结构打包和对齐等功能的 prefix/suffix 头文件。

BOOST_ABI_PREFIX

一个前缀头文件，用于替换 Boost.config 通常选择的任何内容，任何替换都应根据需要设置结构打包和对齐选项。

BOOST_ABI_SUFFIX

一个后缀头文件，用于替换 Boost.config 通常选择的任何内容，任何替换都应撤销前缀头文件的影响。

BOOST_ALL_DYN_LINK

强制所有具有独立源代码的库在 Microsoft Windows 上链接为 DLL 而不是静态库（此宏用于开启 __declspec(dllimport) 修饰符，以便编译器知道在 DLL 中查找哪些符号而不是在静态库中查找）。请注意，有些库只能静态链接（例如 Boost.Test），有些库只能动态链接（例如 Boost.Thread），在这些情况下，此宏无效。

BOOST_WHATEVER_DYN_LINK

强制库“whatever”在 Microsoft Windows 上链接为 DLL 而不是静态库：用您想动态链接的库的名称替换宏名称中的 WHATEVER 部分；例如，使用 BOOST_DATE_TIME_DYN_LINK 或 BOOST_REGEX_DYN_LINK 等（此宏用于开启 __declspec(dllimport) 修饰符，以便编译器知道在 DLL 中查找哪些符号而不是在静态库中查找）。请注意，有些库只能静态链接（例如 Boost.Test），有些库只能动态链接（例如 Boost.Thread），在这些情况下，此宏不受支持。

BOOST_ALL_NO_LIB

告诉配置系统不要自动选择要链接的库。通常，如果编译器支持 #pragma lib，那么只需包含该库的头文件之一，就可以自动选择并链接正确的库构建变体。此宏关闭该功能。

BOOST_WHATEVER_NO_LIB

告诉配置系统不要自动选择要链接的库“whatever”的库。用库的名称替换宏名称中的 WHATEVER；例如 BOOST_DATE_TIME_NO_LIB 或 BOOST_REGEX_NO_LIB。通常，如果编译器支持 #pragma lib，那么只需包含该库的头文件之一，就可以自动选择并链接正确的库构建变体。此宏关闭该功能。

BOOST_LIB_DIAGNOSTIC

导致自动链接代码输出诊断消息，指示所选链接库的名称。

BOOST_LIB_BUILDID

如果您使用 --buildid 选项构建了 Boost，那么将此宏设置为传递给 bjam 的相同值。例如，如果您使用 bjam address-model=64 --buildid=amd64 构建，则使用 -DBOOST_LIB_BUILDID=amd64 编译您的代码，以确保在链接时选择正确的库。

BOOST_LIB_TOOLSET

覆盖链接库名称中 toolset 部分的名称；请注意，如果已定义，则必须将其定义为带引号的字符串字面量，例如“abc”。

config_info.cpp

打印出关于您的编译器/标准库/平台设置以及您当前 Boost 配置的详细描述。此程序提供的信息对于设置 Boost 配置文件非常有用。如果您报告 Boost 为您的编译器/库/平台配置不正确，请在报告所需的更改时附上此程序的输出。

config_test.cpp

一个单体的测试程序，包含大多数单独的测试用例。这提供了一个快速检查，以查看 Boost 是否为您的编译器/库/平台正确配置。

limits_test.cpp

测试您的标准库的 std::numeric_limits 实现（或者如果您定义了 BOOST_NO_LIMITS，则由 Boost 提供的替换项）。这个测试文件在大多数版本的 numeric_limits 中都会失败，主要是因为某些编译器处理 NAN 和无穷大的方式。

no_*pass.cpp

单个编译器缺陷测试文件。这些文件中的每一个都应该可以编译；如果其中一个不能编译，那么就需要定义相应的 BOOST_NO_XXX 宏 - 有关具体细节，请参见每个测试文件。

no_*fail.cpp

单个编译器缺陷测试文件。这些文件中的每一个都不应该可以编译；如果其中一个可以编译，那么就意味着在不需要的时候定义了相应的 BOOST_NO_XXX 宏 - 有关具体细节，请参见每个测试文件。

has_*pass.cpp

单个功能测试文件。如果这些文件中的一个可以编译，那么就意味着在不应该定义的情况下定义了相应的 BOOST_HAS_XXX 宏 - 有关具体细节，请参见每个测试文件。

has_*fail.cpp

单个功能测试文件。如果这些文件中的一个不能编译，那么就意味着在应该定义的情况下没有定义相应的 BOOST_HAS_XXX 宏 - 有关具体细节，请参见每个测试文件。