本文主要介紹 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 目錄中包含的文件列表如下：

[root@node1 /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
[root@node1 /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，如下：

文件 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. 然后，通過修改最外層的 CMakeLists.txt，使用include指令引入 set_cxx_norm.cmake 文件，這樣就可以在源碼目錄中設置想要使用的 C++ 標準了。CMakeList.txt 中新增的 include 指令如下：

3. 最后，修改 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”函數，將整型轉換為字符串類型了。

總結

以上是生活随笔為你收集整理的多C++标准版本指定的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。