CMake中的常用变量的命令

来源 https://zhuanlan.zhihu.com/p/661284439

我们将继续介绍CMake中的一些常用变量和语法说明，以帮助您更好地理解和使用CMake。

CMake变量查询网站：

https://gitlab.kitware.com/cmake/community/wikis/doc/cmake/Useful-Variables

简单说明

引用变量内容需要用\${变量名}格式可以使用message命令查看变量具体内容 message(STATUS "The CMAKE\_VERSION is \${CMAKE\_VERSION}")message(STATUS "The CMAKE\_SOURCE\_DIR is \${CMAKE\_SOURCE\_DIR}")
可以在CMakeLists.txt文件中使用set命令设置某些变量值如set(CMAKE\_BUILD\_TYPE "Release")
可以通过cmake命令行参数设置变量值如cmake -DCMAKE\_BUILD\_TYPE=Release，这种方式会被CMakeLists.txt中set命令设置的变量值覆盖.

常用内置变量

变量名	含义
PROJECT_NAME	project命令中写的项目名
CMAKE_VERSION	当前使用CMake的版本
CMAKE_SOURCE_DIR	工程顶层目录，即入口CMakeLists文件所在路径
PROJECT_SOURCE_DIR	同CMAKE_SOURCE_DIR
CMAKE_BINARY_DIR	工程编译发生的目录，即执行cmake命令进行项目配置的目录，一般为build
PROJECT_BINARY_DIR	同CMAKE_BINARY_DIR
CMAKE_CURRENT_SOURCE_DIR	当前处理的CMakeLists.txt所在的路径
CMAKE_CURRRENT_BINARY_DIR	当前处理的CMakeLists.txt中生成目标文件所在编译目录
CMAKE_CURRENT_LIST_FILE	输出调用这个变量的CMakeLists.txt文件的完整路径
CMAKE_CURRENT_LIST_DIR	当前处理的CMakeLists.txt文件所在目录的路径
CMAKE_INSTALL_PREFIX	指定make install命令执行时包安装路径
CMAKE_MODULE_PATH	find_package命令搜索包路径之一，默认为空

环境变量相关

变量名	含义
CMAKE_PREFIX_PATH	指定额外的包查找路径，可用于查找第三方库的安装目录
CMAKE_INCLUDE_PATH	指定额外的头文件查找路径
CMAKE_LIBRARY_PATH	指定额外的库文件查找路径
CMAKE_FRAMEWORK_PATH	指定额外的框架查找路径（MacOS系统）
___
# 依赖查找相关变量

变量名	含义
_FOUND	根据find_package查找结果，表示是否找到指定的包
_INCLUDE_DIRS	find_package查找到的包的头文件目录
_LIBRARIES	find_package查找到的包的库文件
___

编译配置相关变量

变量名	含义
CMAKE_BUILD_TYPE	编译选项，Release或者Debug，如set(CMAKE_BUILD_TYPE "Release")
CMAKE_CXX_FLAGS	编译标志，设置C++11编译，set(CMAKE_CXX_FLAGS "\${CMAKE_CXX_FLAGS} -std=c++11")
CMAKE_CXX_STANDARD	也可以设置C++11编译，set(CMAKE_CXX_STANDARD 11)
___
# 常用命令

变量名	含义
add_executable()	定义一个可执行文件目标
add_library()	定义一个库目标（静态库或动态库）
add_subdirectory()	添加一个子目录，子目录下需要有CMakeLists.txt文件
add_dependencies()	设置目标之间的依赖关系
target_link_libraries()	为目标添加链接库
target_include_directories()	为目标添加头文件目录
find_package()	查找包并设置相应的变量
include()	包含一个CMake脚本文件
___

条件语句

CMake中支持条件语句，可以根据条件执行不同的命令。以下是一些常用的条件语句： - if(): 如果条件成立，执行其内部的语句 - elseif(): 如果前面的if或elseif条件不成立，而这个条件成立，执行其内部的语句 - else(): 如果前面的if和elseif条件都不成立，执行其内部的语句 - endif(): 结束一个条件语句块

条件语句的常用条件判断

EXISTS : 文件是否存在
DEFINED : 变量是否定义
STREQUAL : 字符串比较，是否相等
LESS : 数字比较，小于
GREATER : 数字比较，大于 - EQUAL : 数字比较，相等

这些变量和语法说明将帮助您更好地编写CMakeLists.txt文件，实现项目的构建和管理。通过学习和掌握CMake，您将能够更轻松地进行跨平台开发和项目维护。

Cmake中的message函数

来源 https://zhuanlan.zhihu.com/p/661285050

message函数说明在CMake中，`message()`函数用于向终端输出信息。

message([<mode>] "message text" ...)函数的<mode>参数可以是以下之一：

(none): 等同于STATUS，但不推荐使用。
STATUS: 输出的信息会被发送到CMake的状态消息流，这是message()函数的默认模式。在命令行上，这些消息通常会被显示出来，但在图形界面中，它们可能会被重定向到其他地方。
WARNING: 输出的信息会被发送到CMake的警告消息流。这些消息会被显示出来，并且会标记为警告。
AUTHOR_WARNING: 这是WARNING模式的一种变体，只有在CMAKE_SUPPRESS_DEVELOPER_WARNINGS变量为FALSE时才会产生警告。
SEND_ERROR: 输出的信息会被发送到CMake的错误消息流，但不会立即停止CMake的处理过程。
FATAL_ERROR: 输出的信息会被发送到CMake的错误消息流，并立即停止CMake的处理过程。

参数	使用场景	底层原理	优点	缺点
(none)	当你想输出一条普通的状态消息，但不希望给它指定任何特殊的模式时。	输出的信息会被发送到CMake的状态消息流。	简单易用，不需要指定模式。	不推荐使用，因为它的行为可能会在未来的CMake版本中改变。
STATUS	当你想输出一条状态消息，例如进度信息或配置信息时。	输出的信息会被发送到CMake的状态消息流。	明确表示这是一条状态消息，易于理解。	在图形界面中，这些消息可能会被重定向到其他地方，不一定能被用户看到。
WARNING	当你想输出一条警告消息，例如某个选项已被弃用或某个操作可能会失败时。	输出的信息会被发送到CMake的警告消息流。	明确表示这是一条警告消息，可以引起用户的注意。	过多的警告消息可能会让用户感到困扰，忽视真正重要的警告。
AUTHOR_WARNING	当你是项目的开发者，并且你想输出一条只有在开发模式下才会显示的警告消息时。	输出的信息会被发送到CMake的警告消息流，但只有在CMAKE_SUPPRESS_DEVELOPER_WARNINGS变量为FALSE时才会产生警告。	可以避免在用户模式下显示不必要的警告。	如果CMAKE_SUPPRESS_DEVELOPER_WARNINGS变量被设置为TRUE，这些警告会被忽略。
SEND_ERROR	当你遇到一个错误，但你希望CMake继续处理剩下的命令时。	输出的信息会被发送到CMake的错误消息流，但不会立即停止CMake的处理过程。	可以在发生错误时继续执行CMake的处理过程。	由于CMake的处理过程没有立即停止，可能会导致更多的错误。
FATAL_ERROR	当你遇到一个严重的错误，你希望立即停止CMake的处理过程时。	输出的信息会被发送到CMake的错误消息流，并立即停止CMake的处理过程。	可以在发生严重错误时立即停止CMake的处理过程，防止错误的扩散。	一旦使用，CMake的处理过程会立即停止，无法执行任何后续的命令。

STATUS

在CMake中，message(STATUS "Your message")常常被用来输出构建过程中的状态信息。以下是一些具体的使用示例：

输出变量的值：

set(MY_VARIABLE "Hello, CMake!")
message(STATUS "MY_VARIABLE is: ${MY_VARIABLE}")

在这个例子中，message(STATUS "MY_VARIABLE is: ${MY_VARIABLE}")会输出一条状态消息，内容为"MY_VARIABLE is: Hello, CMake!"。${MY_VARIABLE}是CMake的变量引用语法，它会被替换为MY_VARIABLE变量的值。

输出配置信息：

option(USE_MY_LIBRARY "Use my library" ON)
message(STATUS "USE_MY_LIBRARY is set to: ${USE_MY_LIBRARY}")

在这个例子中，option(USE_MY_LIBRARY "Use my library" ON)定义了一个名为USE_MY_LIBRARY的选项，初始值为ON。message(STATUS "USE_MY_LIBRARY is set to: ${USE_MY_LIBRARY}")会输出一条状态消息，内容为"USE_MY_LIBRARY is set to: ON"或"USE_MY_LIBRARY is set to: OFF"，取决于USE_MY_LIBRARY选项的值。

输出构建目标信息：

add_library(MyLibrary SHARED src/my_library.cpp)
message(STATUS "Added shared library target: MyLibrary")

在这个例子中，add_library(MyLibrary SHARED src/my_library.cpp)添加了一个名为MyLibrary的共享库目标。message(STATUS "Added shared library target: MyLibrary")会输出一条状态消息，内容为"Added shared library target: MyLibrary"。

这些状态消息在命令行上运行CMake时会被显示出来，帮助你了解CMake的处理过程。在图形界面的CMake工具（如CMake GUI或IDE的CMake集成）中，这些消息可能会被显示在专门的输出窗口或日志文件中。

WARNING

在CMake中，message(WARNING "message text")函数用于输出警告消息。这些消息会被发送到CMake的警告消息流，并在终端中显示出来。同时，这些消息会被标记为警告，这意味着它们可能会引起用户的注意，或者在某些情况下，可能会导致构建过程失败。

例如，假设你正在编写一个需要某个库才能正常工作的项目，你可以使用find_package()函数来查找这个库。如果find_package()函数没有找到这个库，你可以使用message(WARNING)函数来输出一个警告消息，告诉用户这个库没有找到：

find_package(SomeLibrary)
if(NOT SomeLibrary_FOUND)
    message(WARNING "SomeLibrary not found, some features will not be available.")
endif()

在这个例子中，如果CMake在配置过程中没有找到SomeLibrary，它会输出一个警告消息，内容为"SomeLibrary not found, some features will not be available."。这个警告消息会被发送到CMake的警告消息流，并在终端中显示出来，从而让用户知道他们可能需要安装SomeLibrary才能使用所有的功能。

请注意，message(WARNING)函数只是输出警告消息，它不会改变CMake的处理过程。如果你想在发生错误时停止CMake的处理过程，你应该使用message(FATAL_ERROR)函数。

AUTHOR_WARNING

AUTHOR_WARNING模式在CMake中用于输出开发者警告。这种模式的警告只有在CMAKE_SUPPRESS_DEVELOPER_WARNINGS变量为FALSE时才会显示。这个变量默认为FALSE，但如果你在CMakeLists.txt文件中设置了这个变量为TRUE，那么AUTHOR_WARNING模式的警告就不会显示。

这种机制可以用于区分开发者警告和用户警告。例如，如果你是一个库的开发者，你可能希望在开发过程中看到所有的警告，包括开发者警告，但是你的用户可能只关心他们需要知道的警告，不希望看到开发者警告。这时，你就可以在你的CMakeLists.txt文件中使用AUTHOR_WARNING模式来输出开发者警告，然后告诉你的用户设置CMAKE_SUPPRESS_DEVELOPER_WARNINGS变量为TRUE来隐藏这些警告。

以下是一个AUTHOR_WARNING模式的示例：

# 如果某个变量没有被设置，输出一个开发者警告
if(NOT DEFINED MY_VARIABLE)
  message(AUTHOR_WARNING "MY_VARIABLE is not defined")
endif()

在这个示例中，如果MY_VARIABLE变量没有被设置，CMake会输出一个开发者警告，内容为"MY_VARIABLE is not defined"。如果CMAKE_SUPPRESS_DEVELOPER_WARNINGS变量被设置为TRUE，这个警告就不会显示。

SEND_ERROR

SEND_ERROR模式在message()函数中用于输出错误信息，但不会立即停止CMake的处理过程。这意味着CMake会继续处理剩余的命令，直到遇到一个FATAL_ERROR或者处理完所有命令。然后，CMake会以非零状态退出，表示出现了错误。

以下是一个SEND_ERROR的示例：

if(NOT DEFINED REQUIRED_VARIABLE)
    message(SEND_ERROR "REQUIRED_VARIABLE is not defined")
endif()

在这个示例中，我们首先检查变量REQUIRED_VARIABLE是否已经定义。如果没有定义，我们就使用message(SEND_ERROR ...)输出一条错误信息。这条错误信息会被发送到CMake的错误消息流，并且CMake的处理过程不会立即停止。相反，CMake会继续处理剩余的命令，直到遇到一个FATAL_ERROR或者处理完所有命令。然后，CMake会以非零状态退出，表示出现了错误。

请注意，虽然SEND_ERROR不会立即停止CMake的处理过程，但它会阻止生成步骤的执行。也就是说，如果CMake在处理过程中遇到了一个SEND_ERROR，那么即使CMake成功处理了所有命令，生成步骤也不会执行。这是因为SEND_ERROR表示了一个严重的问题，需要用户的注意和修复。

FATAL_ERROR

FATAL_ERROR是CMake中message()函数的一种模式，用于输出错误消息并立即停止CMake的处理过程。当CMake遇到一个无法继续的错误时，你可以使用message(FATAL_ERROR "error message")来输出错误消息并停止处理。

例如，假设你正在编写一个需要C++11或更高版本的项目，你可以使用以下代码来检查C++编译器是否支持C++11：

if(NOT CMAKE_CXX_STANDARD OR CMAKE_CXX_STANDARD LESS 11)
    message(FATAL_ERROR "This project requires C++11 or higher!")
endif()

在这个例子中，如果CMake检测到C++编译器的标准版本小于11，它会输出错误消息"This project requires C++11 or higher!"，并立即停止处理。这意味着CMake不会生成构建系统，也不会执行任何后续的CMake命令。这可以防止在不满足项目要求的情况下尝试构建项目，从而避免可能的构建错误和问题。

请注意，FATAL_ERROR应该谨慎使用，只有在确实需要立即停止CMake处理过程的情况下才应使用。在大多数情况下，使用WARNING或SEND_ERROR模式可能更合适。

CMake String的基本操作

来源 https://zhuanlan.zhihu.com/p/661283261

1. CMake String的基本操作（Basic Operations of CMake String）

1.1 字符串创建与赋值（Creating and Assigning Strings）

在CMake中，我们可以通过多种方式创建和赋值字符串。下面是两种常见的方法：

使用set命令：这是创建和赋值字符串的最直接方式。例如，我们可以创建一个名为VAR的变量，并赋值为Hello, CMake!。

set(VAR "Hello, CMake!")

使用string命令：除了set命令，我们还可以使用string命令的APPEND子命令来创建和赋值字符串。这种方法的优点是可以直接在现有字符串的末尾添加新的内容。

string(APPEND VAR "Hello, CMake!")

同样的，我们也可以通过set命令和string命令的APPEND子命令来赋值字符串。例如，我们可以创建一个新的变量VAR2，并将VAR的值赋给它。

set(VAR2 ${VAR})

或者

string(APPEND VAR2 ${VAR})

下面是这些操作的流程图：

这些是CMake中创建和赋值字符串的基本操作。在接下来的章节中，我们将介绍更多关于CMake String的高级操作和实际应用。

1.2 字符串连接（String Concatenation）

在CMake中，我们可以通过多种方式来连接字符串。下面是两种常见的方法：

使用set命令：我们可以使用set命令来连接两个或多个字符串。例如，我们可以创建一个新的变量VAR3，并将VAR和VAR2的值连接起来赋给它。

set(VAR3 "${VAR} ${VAR2}")

使用string命令：除了set命令，我们还可以使用string命令的CONCAT子命令来连接字符串。这种方法的优点是可以直接在现有字符串的末尾添加新的内容。

string(CONCAT VAR3 "${VAR} ${VAR2}")

下面是这些操作的流程图：

这些是CMake中连接字符串的基本操作。在接下来的章节中，我们将介绍更多关于CMake String的高级操作和实际应用。

1.3 字符串长度（String Length）

在CMake中，我们可以使用string命令的LENGTH子命令来获取字符串的长度。例如，我们可以获取变量VAR的字符串长度，并将结果存储在VAR_LENGTH中。

string(LENGTH "${VAR}" VAR_LENGTH)

下面是这个操作的流程图：

这是CMake中获取字符串长度的基本操作。在接下来的章节中，我们将介绍更多关于CMake String的高级操作和实际应用。

2. CMake String的高级操作（Advanced Operations of CMake String）

2.1 字符串比较（String Comparison）

在CMake中，我们可以使用多种方式来比较字符串。这些比较方法可以分为三类：相等性比较，大小比较，以及字典序比较。

2.1.1 相等性比较（Equality Comparison）

在CMake中，我们可以使用STREQUAL来进行字符串的相等性比较。这个命令会检查两个字符串是否完全相同。如果两个字符串完全相同，那么STREQUAL会返回TRUE，否则返回FALSE。

例如，我们可以这样使用STREQUAL：

if("Hello" STREQUAL "Hello")
  message("Strings are equal.")
else()
  message("Strings are not equal.")
endif()

这段代码会输出Strings are equal.，因为两个字符串是完全相同的。

2.1.2 大小比较（Size Comparison）

在CMake中，我们可以使用STRLESS和STRGREATER来进行字符串的大小比较。这两个命令会根据字符串的长度来比较两个字符串的大小。

例如，我们可以这样使用STRLESS和STRGREATER：

if("Hello" STRLESS "Hello World")
  message("First string is shorter.")
elseif("Hello" STRGREATER "Hi")
  message("First string is longer.")
else()
  message("Strings are of equal length.")
endif()

这段代码会首先输出First string is shorter.，因为"Hello"的长度小于"Hello World"的长度。然后，它会输出First string is longer.，因为"Hello"的长度大于"Hi"的长度。

2.1.3 字典序比较（Lexicographical Comparison）

在CMake中，我们可以使用STRCMP来进行字符串的字典序比较。这个命令会根据字符串的字典序来比较两个字符串的大小。

例如，我们可以这样使用STRCMP：

if("Hello" STRCMP "Hi")
  message("First string comes first in dictionary order.")
else()
  message("Second string comes first in dictionary order.")
endif()

这段代码会输出Second string comes first in dictionary order.，因为在字典序中，"Hi"在"Hello"之前。

以上就是CMake中字符串比较的基本方法。在实际使用中，我们可以根据需要选择合适的比较方法。

2.2 字符串替换（String Replacement）

在CMake中，我们可以使用多种方式来替换字符串中的内容。这些替换方法主要可以分为两类：全局替换和单次替换。

2.2.1 全局替换（Global Replacement）

在CMake中，我们可以使用string(REPLACE)来进行全局替换。这个命令会将字符串中所有匹配的子串替换为指定的新子串。

例如，我们可以这样使用string(REPLACE)：

string(REPLACE "Hello" "Hi" result "Hello, World!")
message(${result})

这段代码会输出Hi, World!，因为它将字符串"Hello, World!"中的"Hello"替换为了"Hi"。

2.2.2 单次替换（Single Replacement）

在CMake中，我们可以使用string(REGEX REPLACE)来进行单次替换。这个命令会将字符串中第一个匹配的子串替换为指定的新子串。

例如，我们可以这样使用string(REGEX REPLACE)：

string(REGEX REPLACE "Hello" "Hi" result "Hello, Hello!")
message(${result})

这段代码会输出Hi, Hello!，因为它将字符串"Hello, Hello!"中的第一个"Hello"替换为了"Hi"。

以上就是CMake中字符串替换的基本方法。在实际使用中，我们可以根据需要选择合适的替换方法。

2.3 字符串分割（String Splitting）

在CMake中，我们可以使用多种方式来分割字符串。这些分割方法主要可以分为两类：使用string(REGEX MATCHALL)和使用string(STRIP)。

2.3.1 使用`string(REGEX MATCHALL)`进行分割

在CMake中，我们可以使用string(REGEX MATCHALL)来进行字符串分割。这个命令会使用正则表达式来匹配字符串中的所有子串。

例如，我们可以这样使用string(REGEX MATCHALL)：

string(REGEX MATCHALL "[0-9]+" result "Hello123World456")
message(${result})

这段代码会输出123 456，因为它将字符串"Hello123World456"中的所有数字子串匹配出来。

2.3.2 使用`string(STRIP)`进行分割

在CMake中，我们可以使用string(STRIP)来进行字符串分割。这个命令会移除字符串两端的空白字符。

例如，我们可以这样使用string(STRIP)：

string(STRIP result " Hello World ")
message(${result})

这段代码会输出Hello World，因为它将字符串" Hello World "两端的空白字符移除了。

以上就是CMake中字符串分割的基本方法。在实际使用中，我们可以根据需要选择合适的分割方法。

第三章：CMake语言（CMake Language）

3.1 字符串（Strings）

在CMake中，字符串是一种基本的数据类型。字符串可以包含任何字符，包括新行（newline）和null字符。字符串是由双引号（"）或者括号（( )）包围的字符序列。

3.1.1 双引号字符串（Quoted Strings）

双引号字符串是由双引号（"）包围的字符序列。例如，"hello, world"就是一个双引号字符串。在双引号字符串中，可以使用反斜杠（\）来转义某些字符，比如：

\"：表示双引号（"）
\：表示反斜杠（\）
\$：表示美元符号（$）
\@：表示@符号（@）

3.1.2 括号字符串（Bracket Argument）

括号字符串是由一对括号（( )）包围的字符序列。括号字符串的开始标记是一个左括号（(），后面紧跟着零个或多个非括号字符，然后是一个右括号（)）。结束标记是一个左括号（(），后面紧跟着与开始标记中的非括号字符相同的字符，然后是一个右括号（)）。例如，(hello, world)就是一个括号字符串。

在括号字符串中，不需要使用反斜杠（\）来转义字符，所有的字符都会被直接解析。这意味着，括号字符串可以包含任何字符，包括双引号（"）、反斜杠（\）、美元符号（$）和@符号（@）。

3.1.3 字符串的比较

在CMake中，字符串的比较是区分大小写的。也就是说，"hello"和"Hello"是两个不同的字符串。如果需要进行不区分大小写的比较，可以使用TOLOWER或者TOUPPER命令将字符串转换为全小写或全大写，然后再进行比较。

3.1.4 字符串的连接

在CMake中，可以使用SET命令或者LIST(APPEND)命令来连接字符串。例如，以下的代码会将"world"添加到变量hello的值的后面：

set(hello "Hello, ")
set(hello "${hello}world!")

执行完以上的代码后，变量hello的值就会变为"Hello, world!"。

3.1.5 字符串的变量

在CMake中，变量是一种可以存储字符串值的数据结构。变量的值可以通过SET命令进行设置，可以通过${}进行访问。

例如，以下的代码创建了一个名为MY_VARIABLE的变量，并将其值设置为"Hello, world!"：

set(MY_VARIABLE "Hello, world!")

然后，可以通过${MY_VARIABLE}来访问这个变量的值。例如，以下的代码会打印出"Hello, world!"：

message(${MY_VARIABLE})

变量的名字是大小写敏感的，也就是说，MY_VARIABLE和my_variable是两个不同的变量。

变量的值可以是任何字符串，包括空字符串。如果一个变量的值是空字符串，那么这个变量就被认为是未定义的。可以使用IF命令来检查一个变量是否被定义：

if(DEFINED MY_VARIABLE)
  message("MY_VARIABLE is defined.")
else()
  message("MY_VARIABLE is not defined.")
endif()

以上的代码会检查MY_VARIABLE是否被定义。如果MY_VARIABLE被定义了，就会打印出"MY_VARIABLE is defined."；如果MY_VARIABLE没有被定义，就会打印出"MY_VARIABLE is not defined."。

变量的值可以通过SET命令进行修改。例如，以下的代码会将MY_VARIABLE的值修改为"Goodbye, world!"：

set(MY_VARIABLE "Goodbye, world!")

执行完以上的代码后，MY_VARIABLE的值就会变为"Goodbye, world!"。

变量的值可以通过UNSET命令进行删除。例如，以下的代码会删除MY_VARIABLE的值：

unset(MY_VARIABLE)

执行完以上的代码后，MY_VARIABLE的值就会变为未定义。

变量可以被用在任何需要字符串的地方，包括命令的参数、文件名、路径名等等。这使得变量成为了CMake中最重要的数据结构之一。

3.2 字符串的操作（String Operations）

![在这里插入图片描述](https://img-blog.csdnimg.cn/d4c049057a9b41f29b232bbe144d4439.png 在CMake中，字符串的操作主要包括连接（concatenation）、替换（replacement）和比较（comparison）。以下是这些操作的详细介绍：

3.2.1 字符串的连接（String Concatenation）

在CMake中，可以使用SET命令或者LIST(APPEND)命令来连接字符串。例如，以下的代码会将"world"添加到变量hello的值的后面：

set(hello "Hello, ")
set(hello "${hello}world!")

执行完以上的代码后，变量hello的值就会变为"Hello, world!"。

3.2.2 字符串的替换（String Replacement）

在CMake中，可以使用STRING(REPLACE)命令来替换字符串中的某些字符。例如，以下的代码会将变量hello的值中的"world"替换为"universe"：

string(REPLACE "world" "universe" hello ${hello})

执行完以上的代码后，变量hello的值就会变为"Hello, universe!"。

3.2.3 字符串的比较（String Comparison）

在CMake中，可以使用IF命令来比较两个字符串。例如，以下的代码会比较变量hello的值和"Hello, universe!"是否相等：

if(${hello} STREQUAL "Hello, universe!")
  message("The strings are equal.")
else()
  message("The strings are not equal.")
endif()

执行完以上的代码后，如果变量hello的值和"Hello, universe!"相等，就会打印出"The strings are equal."；如果不相等，就会打印出"The strings are not equal."。

3.3 字符串的性能优化（Performance Optimization）

在CMake中，字符串的操作可能会影响到整个项目构建的性能。以下是一些可以用来优化字符串操作性能的技巧：

3.3.1 避免不必要的字符串操作（Avoid Unnecessary String Operations）

在CMake中，每一个字符串操作都会消耗一定的时间和内存。因此，避免不必要的字符串操作是优化性能的一个重要手段。

例如，如果一个变量的值在整个项目构建过程中都不会改变，那么就没有必要在每次使用这个变量的时候都去计算它的值。可以在项目构建开始的时候就计算出这个变量的值，然后在后面的构建过程中直接使用这个值。

3.3.2 使用更高效的字符串操作命令（Use More Efficient String Operations）

在CMake中，有一些命令可以用来进行字符串操作，比如SET、LIST和STRING。这些命令在处理大量数据时的性能可能会有所不同。

例如，LIST命令在处理大量数据时的性能可能会比SET命令更高。因此，如果需要对一个包含大量元素的列表进行操作，可以考虑使用LIST命令而不是SET命令。

3.3.3 利用CMake的缓存机制（Leverage CMake's Caching Mechanism）

在CMake中，可以使用SET命令的CACHE选项来将一个变量的值存储在CMake的缓存中。这样，在后续的构建过程中，就可以直接从缓存中读取这个变量的值，而不需要再次计算它的值。

例如，以下的代码会将变量hello的值存储在CMake的缓存中：

set(hello "Hello, world!" CACHE STRING "The value of hello")

执行完以上的代码后，变量hello的值就会被存储在CMake的缓存中。在后续的构建过程中，可以通过${hello}来直接从缓存中读取这个变量的值。

第四章：字符串（String）操作

在CMake中，字符串操作是非常常见且重要的一部分。我们可以通过各种方式来操作和处理字符串，以满足我们的需求。

4.1 字符串（String）函数

在CMake中，我们可以使用string()函数来进行字符串操作。这个函数提供了多种模式，可以用来处理字符串。下面我们将详细介绍这些模式。

4.1.1 REGEX MATCH

string(REGEX MATCH <regex> <output variable> <input> [<input>...])

这个模式用于在输入字符串中查找与正则表达式匹配的部分。如果找到匹配的部分，它将被存储在输出变量中。

例如，如果我们有一个字符串"Hello, CMake!"，我们可以使用正则表达式"CMake"来查找这个字符串。如果找到匹配的部分，"CMake"将被存储在输出变量中。

4.1.2 REGEX REPLACE

string(REGEX REPLACE <regex> <replace> <output variable> <input> [<input>...])

这个模式用于替换输入字符串中与正则表达式匹配的部分。替换的内容由<replace>参数指定。

例如，如果我们有一个字符串"Hello, CMake!"，我们可以使用正则表达式"CMake"和替换字符串"World"来替换这个字符串。替换后的字符串将被存储在输出变量中，结果为"Hello, World!"。

4.1.3 CONCAT

string(CONCAT <output variable> <input> [<input>...])

这个模式用于连接输入字符串。所有的输入字符串将被连接在一起，并存储在输出变量中。

例如，如果我们有两个字符串"Hello, "和"CMake!"，我们可以使用CONCAT模式来连接这两个字符串。连接后的字符串将被存储在输出变量中，结果为"Hello, CMake!"。

以上就是string()函数的一些常见模式。在实际使用中，我们可以根据需要选择合适的模式来处理字符串。

4.2 在项目构建中的应用（Application in Project Building）

在实际的项目构建中，CMake String的应用是非常广泛的。下面我们将详细介绍在项目构建中如何使用CMake String。

4.2.1 字符串长度（Length）

在CMake中，我们可以使用string(LENGTH <string> <output variable>)函数来获取字符串的长度。这在处理文件路径或者其他需要计算长度的场景中非常有用。

例如，我们可以通过计算文件路径的长度，来判断路径是否超过了系统的最大路径长度限制。

4.2.2 字符串比较（Comparison）

在CMake中，我们可以使用string(COMPARE <EQUAL|NOTEQUAL|LESS|GREATER> <string1> <string2> <output variable>)函数来比较两个字符串。这在处理版本号或者其他需要比较的场景中非常有用。

例如，我们可以通过比较两个版本号字符串，来判断一个软件是否需要更新。

4.2.3 字符串查找（Find）

在CMake中，我们可以使用string(FIND <string> <substring> <output variable> [<start>])函数来查找一个字符串在另一个字符串中的位置。这在处理文件路径或者其他需要查找的场景中非常有用。

例如，我们可以通过查找文件路径中的某个子路径，来判断一个文件是否在某个目录下。

以上就是在项目构建中如何使用CMake String的一些实际应用。在实际使用中，我们可以根据需要选择合适的函数来处理字符串。

4.3 在自动化测试中的应用（Application in Automated Testing）

在自动化测试中，CMake String的应用也是非常广泛的。下面我们将详细介绍在自动化测试中如何使用CMake String。

4.3.1 字符串替换（Replace）

在CMake中，我们可以使用string(REPLACE <substring> <replace> <output variable> <input>)函数来替换字符串中的某个子字符串。这在处理测试用例或者其他需要替换的场景中非常有用。

例如，我们可以通过替换测试用例中的某个参数，来生成不同的测试用例。

4.3.2 字符串分割（Split）

在CMake中，我们可以使用string(REPLACE <delimiter> <output variable> <input>)函数来分割字符串。这在处理测试结果或者其他需要分割的场景中非常有用。

例如，我们可以通过分割测试结果的字符串，来获取每个测试用例的结果。

4.3.3 字符串转换（Conversion）

在CMake中，我们可以使用string(TOUPPER <string> <output variable>)、string(TOLOWER <string> <output variable>)等函数来转换字符串的大小写。这在处理测试用例或者其他需要转换的场景中非常有用。

例如，我们可以通过转换测试用例的字符串，来生成不同的测试用例。

以上就是在自动化测试中如何使用CMake String的一些实际应用。在实际使用中，我们可以根据需要选择合适的函数来处理字符串。

======== End

posted @ 2024-02-09 14:47 lsgxeva 阅读(557) 评论(0) 编辑收藏举报

刷新页面返回顶部

云水

MyGitee - https://gitee.com/lsgx/ MyGithub - https://github.com/lsgxeva/ Download - https://d.serctl.com Proxy - tcp://frpgz1.idcfengye.com:10000

CMake中的常用变量的命令

CMake中的常用变量的命令

CMake变量查询网站：

简单说明

常用内置变量

环境变量相关

编译配置相关变量

条件语句

条件语句的常用条件判断

Cmake中的message函数

message函数说明 在CMake中，message()函数用于向终端输出信息。

STATUS

WARNING

AUTHOR_WARNING

SEND_ERROR

FATAL_ERROR

CMake String的基本操作

1. CMake String的基本操作（Basic Operations of CMake String）

1.1 字符串创建与赋值（Creating and Assigning Strings）

1.2 字符串连接（String Concatenation）

1.3 字符串长度（String Length）

2. CMake String的高级操作（Advanced Operations of CMake String）

2.1 字符串比较（String Comparison）

2.1.1 相等性比较（Equality Comparison）

2.1.2 大小比较（Size Comparison）

2.1.3 字典序比较（Lexicographical Comparison）

2.2 字符串替换（String Replacement）

2.2.1 全局替换（Global Replacement）

2.2.2 单次替换（Single Replacement）

2.3 字符串分割（String Splitting）

2.3.1 使用string(REGEX MATCHALL)进行分割

2.3.2 使用string(STRIP)进行分割

第三章：CMake语言（CMake Language）

3.1 字符串（Strings）

3.1.1 双引号字符串（Quoted Strings）

3.1.2 括号字符串（Bracket Argument）

3.1.3 字符串的比较

3.1.4 字符串的连接

3.1.5 字符串的变量

3.2 字符串的操作（String Operations）

3.2.1 字符串的连接（String Concatenation）

3.2.2 字符串的替换（String Replacement）

3.2.3 字符串的比较（String Comparison）

3.3 字符串的性能优化（Performance Optimization）

3.3.1 避免不必要的字符串操作（Avoid Unnecessary String Operations）

3.3.2 使用更高效的字符串操作命令（Use More Efficient String Operations）

3.3.3 利用CMake的缓存机制（Leverage CMake's Caching Mechanism）

第四章：字符串（String）操作

4.1 字符串（String）函数

4.1.1 REGEX MATCH

4.1.2 REGEX REPLACE

4.1.3 CONCAT

4.2 在项目构建中的应用（Application in Project Building）

4.2.1 字符串长度（Length）

4.2.2 字符串比较（Comparison）

4.2.3 字符串查找（Find）

4.3 在自动化测试中的应用（Application in Automated Testing）

4.3.1 字符串替换（Replace）

4.3.2 字符串分割（Split）

4.3.3 字符串转换（Conversion）

公告

MyGitee - https://gitee.com/lsgx/
MyGithub - https://github.com/lsgxeva/
Download - https://d.serctl.com
Proxy - tcp://frpgz1.idcfengye.com:10000

message函数说明在CMake中，`message()`函数用于向终端输出信息。

2.3.1 使用`string(REGEX MATCHALL)`进行分割

2.3.2 使用`string(STRIP)`进行分割