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 1.69 以來，Boost.System 是僅標頭檔。為了相容性，仍然會建置一個存根函式庫，但不再需要連結到它。

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程式庫，²刪除檔案名稱開頭的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   結論和更多資源

這結束了您對 Boost 的簡介，以及將它與您的程式整合的方式。當您開始認真使用 Boost 時，肯定還有一些我們希望涵蓋的額外重點。有一天，我們可能會推出「入門系列第 2 冊」，其中會解決這些問題。在此之前，我們建議您尋求以下資源。如果您找不到您需要的內容，或者有任何我們可以改進此文件清晰度的地方，請將其發佈到 Boost 使用者郵件清單。

• Boost.Build 參考手冊
• Boost 使用者郵件清單
• 所有 Boost 程式庫文件的索引