本文主要介紹CMake中include指令的用法。

1 概述

引用CMake官網對於include指令的介紹，如下：

Load and run CMake code from a file or module.

include指令的用法如下：

include(<file|module> [OPTIONAL] [RESULT_VARIABLE <VAR>] [NO_POLICY_SCOPE])

Load and run CMake code from the file given. Variable reads and writes access the scope of the caller (dynamic scoping). If OPTIONAL is present, then no error is raised if the file does not exist. If RESULT_VARIABLE is given, the variable will be set to the full filename which has been included or NOTFOUND if it failed.

If a module is specified instead of a file, the file with name <modulename>.cmake is searched first in CMAKE_MODULE_PATH, then in the CMake module directory. There is one exception to this: if the file which calls include() is located itself in the CMake builtin module directory, then first the CMake builtin module directory is searched and CMAKE_MODULE_PATH afterwards. See also policy CMP0017.

See the cmake_policy() command documentation for discussion of the NO_POLICY_SCOPE option.

2 作用

從前面所述，我們知道了include指令用來載入並執行來自於檔案或模組的CMake程式碼。

在這裡我們針對一些具體的問題場景，介紹include指令的用法。

2.1 多C++標準版本指定

有時我們會有這樣一種需求，在使用同一個外層 CMakeLists.txt 的前提下，每個原始碼子目錄中要求使用的C++標準版本不同，有的原始碼要求使用c++98標準編譯、有的原始碼要求使用c++11標準編譯，這時我們就可以使用include指令來滿足這樣的需求了。

2.1.1 專案程式碼結構及內容

在這裡，我們使用《CMake介紹及用法示例》中的專案程式碼結構，並在其基礎上做一些改動，改動後的專案程式碼結構如下：

相比於之前的專案程式碼結構，我們增加了“cmake_dir3”這個原始碼目錄，同時，修改了最外層的CMakeLists.txt。

cmake_dir3中包含的檔案列表如下：

[[email protected] /opt/liitdar/mydemos/simples/cmake_test]# l cmake_dir3
total 8
-rw-r--r--. 1 root root 257 Jul 21 14:19 CMakeLists.txt
-rw-r--r--. 1 root root 258 Jul 21 14:19 main.cpp
[[email protected] /opt/liitdar/mydemos/simples/cmake_test]# 

其中，CMakeLists.txt內容如下：

# 遍歷當前路徑下的所有原始檔，並將其新增到變數DIR_SRCS中
aux_source_directory(. DIR_SRCS)

# 新增名為cmake_test3的可執行檔案，該檔案會由變數DIR_SRCS中的原始檔構建生成
add_executable(cmake_test3 ${DIR_SRCS})

main.cpp內容如下：

#include <iostream>
#include <string>

using namespace std;

int main()
{
    int a = 100;
    string strTest;

    strTest = to_string(a) + " is a string.";

    cout << "a is: " << a << endl;
    cout << "pszTest is: " << strTest << endl;

    return 0;
}

最外層的CMakeLists.txt改動部分（新增了cmake_dir3原始碼目錄）如下：

2.1.2 專案構建

此時，我們對上述專案使用CMake進行構建，如下：

從上圖中可以看到，專案構建失敗了，因為在cmake_dir3中存在“to_string”函式，該函式需要在c++11標準下進行編譯，而預設使用的都是c++98標準。

2.1.3 解決方案

此時，我們就需要為cmake_dir3設定不同的c++標準進行編譯了。具體步驟如下：

1. 我們在最外層的CMakeList.txt的同級目錄下，增加一個檔案set_cxx_norm.cmake，如下：

通過在最外層的CMakeLists.txt中使用include指令引入該檔案，我們就可以在原始碼目錄中設定想要使用的c++標準了。

set_cxx_norm.cmake的內容如下：

# set c++ norm value, these values will be used for comparision later
set(CXX_NORM_CXX98 1)   # C++98
set(CXX_NORM_CXX03 2)   # C++03
set(CXX_NORM_CXX11 3)   # C++11

# Set the wanted C++ norm
# Adds the good argument to the command line in function of the compiler
macro(set_cxx_norm NORM)
    # Extract c++ compiler --version output
    exec_program(
        ${CMAKE_CXX_COMPILER}
        ARGS --version
        OUTPUT_VARIABLE _compiler_output
    )
    # Keep only the first line
    string(REGEX REPLACE
        "(\n.*$)"
        ""
        cxx_compiler_version "${_compiler_output}"
    )
    # Extract the version number
    string(REGEX REPLACE
        "([^0-9.])|([0-9.][^0-9.])"
        ""
        cxx_compiler_version "${cxx_compiler_version}"
    )

    # Set the specific C++ norm According 'NORM'
    if(${NORM} EQUAL ${CXX_NORM_CXX98})
        add_definitions("-std=c++98")
    elseif(${NORM} EQUAL ${CXX_NORM_CXX03})
        add_definitions("-std=c++03")
    elseif(${NORM} EQUAL ${CXX_NORM_CXX11})
        if(${cxx_compiler_version} VERSION_LESS "4.7.0")
            add_definitions("-std=c++0x")
        else()
            add_definitions("-std=c++11")
        endif()
    endif()

endmacro()

2. 然後，我們需要修改cmake_dir3的CMakeLists.txt檔案，新增“要使用c++11標準”的語句，如下：

# 使用c++11標準
set_cxx_norm(${CXX_NORM_CXX11})

完成上述修改後，再次進行專案構建，結果如下：

在上圖中我們可以看到，專案構建成功了。此時，cmake_test1和cmake_test2使用的是c++98（預設）標準；而cmake_test3使用的是c++11標準。

執行cmake_test3程式，結果如下：

上面的執行結果表明，cmake_test3成功呼叫了c++11標準的“to_string”函式，將整型轉換為字串型別了。