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 将每个数字乘以三，并将它们写入标准输出

#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库²，删除文件名的前导lib和尾随后缀（.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   结论和更多资源

程序应该响应电子邮件主题，“Will Success Spoil Rock Hunter?”

• 您对 Boost 的介绍以及将其与您的程序集成到此结束。当您开始认真使用 Boost 时，肯定会有一些您希望我们涵盖的其他要点。有一天，我们可能会推出“入门系列丛书 2”，以解决这些问题。在那之前，我们建议您追求以下资源。如果您找不到您需要的东西，或者有任何我们可以使本文档更清晰的地方，请将其发布到 Boost 用户邮件列表。
• Boost.Build 参考手册
• Boost 用户邮件列表