CMakeForEach：如何有效使用CMake中的循環功能？

CMake是一個免費的開源跨平台編譯工具，用於組織和構建C++軟件項目。它是由Kitware公司開發的，支持多種操作系統，包括Windows，Linux，OS X等。CMake具有許多重要的功能，其中之一是ForEach循環。本文將介紹如何使用CMake中的循環功能。

一、CMakeForEach的基本語法

CMake中的ForEach循環語句的語法如下：

“`cmake
foreach( )
# some code here
endforeach()
“`

其中，“表示循環中被賦值的變量，“是一個列表，可以是由空格分隔的多個值，也可以是一個CMake變量。`# some code here`部分是要執行的代碼塊，它將運行一次循環中的每個元素。下面是一個簡單的示例：

“`cmake
set(LIST_OF_THINGS thing1 thing2 thing3 thing4)
foreach(ITEM ${LIST_OF_THINGS})
message(“The current item is ${ITEM}”)
endforeach()
“`

上面的代碼會依次打印出`The current item is thing1`、`The current item is thing2`、`The current item is thing3`和`The current item is thing4`。

二、使用CMakeForEach的場景

CMakeForEach通常用於遍歷目錄，處理文件列表，設置編譯器選項等任務。

1、遍歷目錄

在CMake中使用foreach可以方便地遍歷目錄中的所有文件。我們可以使用file命令獲取目錄中的文件列表，然後使用foreach遍歷文件列表，並對每個文件執行指定的操作。例如：

“`cmake
file(GLOB FILES “./src/*.cpp”)
foreach(FILE ${FILES})
message(“The current file is ${FILE}”)
endforeach()
“`

上面的代碼會打印出`./src/main.cpp`和`./src/helper.cpp`，這是目錄中兩個CPP源文件的列表。

2、處理文件列表

使用CMake，我們可以將一堆文件的名稱存儲在一個變量中，然後使用foreach循環對列表中的每個文件執行指定的操作。例如，我們可以在變量`SOURCES`中指定源文件的名稱，並將它們添加到一個可執行目標中：

“`cmake
set(SOURCES main.cpp helper.cpp)
add_executable(myexe ${SOURCES})
“`

然後我們可以將新的可執行文件`myexe`添加到項目中進行構建。如果我們想要在一個特定目錄中的所有源文件中添加一些預編譯的頭文件（例如`utils.h`），可以使用以下代碼：

“`cmake
file(GLOB SOURCES “./src/*.cpp”)
foreach (SOURCE ${SOURCES})
target_include_directories(myexe PRIVATE ${SOURCE_DIR})
…
endforeach()
“`

上面的代碼會將`./src`中的所有源文件中都包含`utils.h`頭文件。

3、設置編譯器選項

在CMake中，使用target_compile_options可以為一組源文件設置編譯器選項。例如，假設我們有兩個源文件，它們使用不同的C++標準進行編譯，我們可以使用foreach循環為它們分別設置不同的標準：

“`cmake
set(STANDARD_FLAGS -std=c++11)
set(CMAKE_CXX_FLAGS “${CMAKE_CXX_FLAGS} ${STANDARD_FLAGS}”)
set(SOURCE_FILES main.cpp helper.cpp)
foreach(SOURCE_FILE ${SOURCE_FILES})
if(“${SOURCE_FILE}” MATCHES “helper.cpp”)
set_source_files_properties(${SOURCE_FILE} PROPERTIES COMPILE_FLAGS -std=c++14)
message(STATUS “Added option to ${SOURCE_FILE}”)
endif()
endforeach()
“`

上面的代碼將為`main.cpp`指定C++11標準，為`helper.cpp`指定C++14標準。我們可以使用set_source_files_properties設置COMPILE_FLAGS屬性來設置每個源文件的編譯器選項。

三、完整示例代碼

下面是一個完整的示例代碼，它演示了在CMake中使用foreach循環遍歷源文件、處理文件列表和設置編譯器選項的方法。

“`cmake
cmake_minimum_required(VERSION 3.10)

project(MyProject VERSION 1.0)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED True)
set(CMAKE_CXX_FLAGS “${CMAKE_CXX_FLAGS} -Wall”)

file(GLOB SOURCES “./src/*.cpp”)
foreach(SOURCE ${SOURCES})
if(“${SOURCE}” MATCHES “helper.cpp”)
set_source_files_properties(${SOURCE} PROPERTIES COMPILE_FLAGS -std=c++14)
message(STATUS “Added option to ${SOURCE}”)
else()
set_source_files_properties(${SOURCE} PROPERTIES COMPILE_FLAGS -std=c++11)
endif()
target_include_directories(myexe PRIVATE ${PROJECT_SOURCE_DIR}/include)
target_link_libraries(myexe PRIVATE somelib)
endforeach()

add_executable(myexe ${SOURCES})

install(TARGETS myexe DESTINATION bin)
“`

上面的代碼將設置C++標準為C++17，並將Wall選項添加到編譯器中。然後，使用file命令找到`./src`目錄中的所有源文件，使用foreach循環遍歷每個源文件，使用set_source_files_properties為每個源文件設置編譯器選項。最後，將所有源文件添加到可執行目標中。