1   获取 Boost

获取 Boost 副本最可靠的方法是从 SourceForge 下载发行版。

1. 下载 boost_1_82_0.tar.bz2。

2. 在您想要放置 Boost 安装的目录中，执行

   tar --bzip2 -xf /path/to/boost_1_82_0.tar.bz2
   

2   Boost 发行版

这是生成的目录结构的草图

boost_1_82_0/ .................The “boost root directory”
   index.htm .........A copy of www.boost.org starts here
   boost/ .........................All Boost Header files
   `` ``
   libs/ ............Tests, .cpps, docs, etc., by library
     index.html ........Library documentation starts here
     algorithm/
     any/
     array/
                     …more libraries…
   status/ .........................Boost-wide test suite
   tools/ ...........Utilities, e.g. Boost.Build, quickbook, bcp
   more/ ..........................Policy documents, etc.
   doc/ ...............A subset of all Boost library docs

需要注意以下几点

1. 到**Boost 根目录**（通常为/usr/local/boost_1_82_0）的路径有时在文档和邮件列表中称为$BOOST_ROOT。

2. 要编译 Boost 中的任何内容，您都需要一个包含boost/子目录的目录在您的#include路径中。`` ``

3. 由于 Boost 的所有头文件都具有.hpp扩展名，并且位于boost/Boost 根目录的子目录中，因此您的 Boost#include指令将如下所示

   #include <boost/whatever.hpp>
   

   或

   #include "boost/whatever.hpp"
   

   这取决于您对使用尖括号包含的偏好。`` ``

4. 不要被doc/子目录分心；它仅包含 Boost 文档的一个子集。从libs/index.html开始，如果您正在寻找完整的文档。

3   仅限头文件的库

许多人首先想知道的是：“如何构建 Boost？”好消息是，通常不需要构建任何内容。

唯一必须单独构建的 Boost 库是

• Boost.Chrono
• Boost.Context
• Boost.Filesystem
• Boost.GraphParallel
• Boost.IOStreams
• Boost.Locale
• Boost.Log（请参阅 构建文档）
• Boost.MPI
• Boost.ProgramOptions
• Boost.Python（在构建和安装它之前，请参阅 Boost.Python 构建文档）
• Boost.Regex
• Boost.Serialization
• Boost.Thread
• Boost.Timer
• Boost.Wave

一些库具有可选的单独编译的二进制文件

• Boost.Graph 还有一个二进制组件，只有在您打算 解析 GraphViz 文件 时才需要它。
• Boost.Math 具有用于 TR1 和 C99 cmath 函数的二进制组件。
• Boost.Random 具有一个二进制组件，只有在您使用random_device.
• Boost.Test 可以以“仅限头文件”或“单独编译”模式使用，尽管对于严肃用途建议单独编译。
• Boost.Exception 为 32 位 _MSC_VER==1310 和 _MSC_VER==1400 提供了 exception_ptr 的非侵入式实现，这需要单独编译的二进制文件。这通过 #define BOOST_ENABLE_NON_INTRUSIVE_EXCEPTION_PTR 启用。
• Boost.System 从 Boost 1.69 开始就是仅限头文件的。出于兼容性考虑，仍然会构建一个存根库，但不再需要链接到它。

4   使用 Boost 构建简单的程序

为了简单起见，让我们从使用仅限头文件的库开始。以下程序从标准输入读取一系列整数，使用 Boost.Lambda 将每个数字乘以 3，并将它们写入标准输出

#include <boost/lambda/lambda.hpp>
#include <iostream>
#include <iterator>
#include <algorithm>

int main()
{
    using namespace boost::lambda;
    typedef std::istream_iterator<int> in;

    std::for_each(
        in(std::cin), in(), std::cout << (_1 * 3) << " " );
}

将此程序的文本复制到名为example.cpp.

现在，在您保存example.cpp的目录中，发出以下命令

c++ -I path/to/boost_1_82_0 example.cpp -o example

要测试结果，请键入

echo 1 2 3 | ./example

5   准备使用 Boost 库二进制文件

如果您想使用任何单独编译的 Boost 库，则需要获取库二进制文件。

$ cd path/to/boost_1_82_0
$ ./bootstrap.sh --help

$ ./bootstrap.sh --prefix=path/to/installation/prefix

$ ./b2 install

b2 --build-dir=build-directory toolset=toolset-name `` `` stage

$ cd ~/boost_1_82_0
$ b2 --build-dir=/tmp/build-boost toolset=gcc stage

b2 --help

6   将您的程序链接到 Boost 库

为了演示如何与 Boost 二进制库链接，我们将使用以下从电子邮件中提取主题行的简单程序。它使用Boost.Regex 库，该库具有一个单独编译的二进制组件。

#include <boost/regex.hpp>
#include <iostream>
#include <string>

int main()
{
    std::string line;
    boost::regex pat( "^Subject: (Re: |Aw: )*(.*)" );

    while (std::cin)
    {
        std::getline(std::cin, line);
        boost::smatch matches;
        if (boost::regex_match(line, matches, pat))
            std::cout << matches[2] << std::endl;
    }
}

与链接相关的两个主要挑战是

1. 工具配置，例如选择命令行选项或 IDE 构建设置。
2. 在所有构建变体中识别与项目其余部分的编译配置兼容的库二进制文件。

链接库主要有两种方法

1. 您可以指定每个库的完整路径

   $ c++ -I path/to/boost_1_82_0 example.cpp -o example \
      ~/boost/stage/lib/libboost_regex-gcc34-mt-d-1_36.a
   

2. 您可以分别指定要搜索的目录（使用-L目录）和要搜索的库名称（使用-l库，² 删除文件名开头的库和结尾的后缀（.a在本例中）

   $ c++ -I path/to/boost_1_82_0 example.cpp -o example \
      -L~/boost/stage/lib/ -lboost_regex-gcc34-mt-d-1_36
   

   如您所见，对于一个库来说，此方法与方法 A 一样简洁；当您使用来自同一目录的多个库时，它确实非常有用。但是请注意，如果您将此方法与同时具有静态（.a）和动态（.so）构建的库一起使用，除非您传递一个特殊的选项（例如-static）到命令行，否则系统可能会自动为您选择一个。

在以上两种情况下，粗体文本都是您添加到我们之前探讨的命令行中的内容。

To: George Shmidlap
From: Rita Marlowe
Subject: Will Success Spoil Rock Hunter?
---
See subject.

$ VARIABLE_NAME=path/to/lib/directory:${VARIABLE_NAME}
$ export VARIABLE_NAME

$ setenv VARIABLE_NAME path/to/lib/directory:${VARIABLE_NAME}

$ path/to/compiled/example < path/to/jayne.txt

7   结论和更多资源

这结束了您对 Boost 及其与程序集成的介绍。当您开始认真使用 Boost 时，您肯定希望我们能介绍一些其他要点。有一天，我们可能会有一本“入门系列第 2 版”来解决这些问题。在此之前，我们建议您参考以下资源。如果您找不到所需内容，或者有任何我们可以做的事情使本文档更清晰，请将其发布到Boost 用户邮件列表。

• Boost.Build 参考手册
• Boost 用户邮件列表
• 所有 Boost 库文档的索引