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 生成的配置脚本），请定义此项。

BOOST_NO_STDLIB_CONFIG

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

BOOST_NO_PLATFORM_CONFIG

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

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 头文件包含任何通常控制结构体打包和对齐等内容的前缀/后缀头文件。

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

覆盖链接的库名称的工具集部分的名称；请注意，如果定义，则必须将其定义为带引号的字符串文字，例如 "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 宏 - 有关具体细节，请参阅每个测试文件。