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 可用，也会禁用它们的使用。除非设置了 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 和 infinity 的方式。

no_*pass.cpp

单个编译器缺陷测试文件。如果其中一个文件无法编译，则需要定义相应的 BOOST_NO_XXX 宏 - 请参阅每个测试文件以获取具体详细信息。

no_*fail.cpp

单个编译器缺陷测试文件。如果其中一个文件可以编译，则在不需要时定义了相应的 BOOST_NO_XXX 宏 - 请参阅每个测试文件以获取具体详细信息。

has_*pass.cpp

单个特性测试文件。如果其中一个文件无法编译，则在不应定义时定义了相应的 BOOST_HAS_XXX 宏 - 请参阅每个测试文件以获取具体详细信息。

has_*fail.cpp

单个特性测试文件。如果其中一个文件可以编译，则可以安全地定义相应的 BOOST_HAS_XXX 宏 - 请参阅每个测试文件以获取具体详细信息。