深入理解CMake生成器表达式

来源：网络更新时间：2024-10-31 09:32:15

【写在前面】

CMake的生成器表达式是用于在构建系统级别上进行条件判断和逻辑运算的工具。它们通常用于目标属性和生成器表达式上下文中，允许根据不同的平台、配置或编译器来定制构建过程。

本文引用的文档链接：

cmake 生成器表达式 (7) — CMake 3.26.4 Documentation

【正文开始】

本篇文章将介绍《条件表达式》和《逻辑运算符》。

条件表达式：

生成器表达式的一个基本类别与条件逻辑有关。支持两种形式的条件生成器表达式：

$

如果 condition 为 “1”，则评估为“true_string”，如果 condition 评估为“0”，则评估为空字符串。 condition 的任何其他值都会导致错误。

$

在3.8版本加入。

如果 condition 为 “1”，则评估为“true_string”，如果 condition 为“0”，则评估为“false_string”。 condition 的任何其他值都会导致错误。

通常， condition 本身就是一个生成器表达式。例如，当使用 Debug 配置时，以下表达式扩展为 DEBUG_MODE ，所有其他配置为空字符串：

$<$:DEBUG_MODE>

使用示例：

#条件表达式 $
#等价于C++ if (condition == "1") return true_string else return ""
add_custom_command(
   TARGET MyExecutable PRE_BUILD
   COMMAND ${CMAKE_COMMAND} -E echo "[1]: WIN32: ${WIN32} | $<${WIN32}:is win32> | $<0:is 0>"
)

#条件表达式 $
#等价于C++ condition ? true_string : false_string
set(IS_DEBUG "1")
add_custom_command(
   TARGET MyExecutable PRE_BUILD
   COMMAND ${CMAKE_COMMAND} -E echo "[2]: IS_DEBUG: ${IS_DEBUG} | $"
)

除了 1 或 0 之外的类似布尔的 condition 值可以通过用 $ 生成器表达式包装它们来处理：

$

将 string 转换为 0 或 1 。如果以下任何一项为真，则评估为“0”：

string 为空，

string 是不区分大小写的等于 0 、 FALSE 、 OFF 、 N 、 NO 、 IGNORE 或 NOTFOUND

string 以后缀 -NOTFOUND 结尾（区分大小写）。

否则计算为“1”。

当CMake变量提供 condition 时，经常使用 $ 生成器表达式：

$<$:-DENABLE_SOME_FEATURE>

使用示例：

#条件表达式 $
#等价于C++ if (string) return "1" else return "0"
set(STRING2BOOL "not empty")
add_custom_command(
   TARGET MyExecutable PRE_BUILD
   COMMAND ${CMAKE_COMMAND} -E echo "[3]: STRING2BOOL: ${STRING2BOOL} | $ | $<$:STRING2BOOL is not empty>"
)

三个示例的输出如下：

逻辑运算符

支持常见的布尔逻辑运算符：

$

其中 conditions 是以逗号分隔的布尔表达式列表，所有这些表达式的计算结果必须为 1 或 0 。如果所有条件都为“1”，则整个表达式的计算结果为“1”。如果任何条件为“0”，则整个表达式的计算结果为“0”。

$

其中 conditions 是以逗号分隔的布尔表达式列表。所有这些都必须评估为“1”或“0”。如果 condition 中的至少一个为“1”，则整个表达式的计算结果为“1”。如果所有 condition 的计算结果为“0”，则整个表达式的计算结果为“0”。

$

condition 必须是 0 或 1 。如果 condition 为“1”，则表达式的结果为“0”，否则为“1”。

使用示例：

#逻辑运算符 $
#等价于C++ if (condition && condition && ...) return "1" else return "0"
add_custom_command(
   TARGET MyExecutable PRE_BUILD
   COMMAND ${CMAKE_COMMAND} -E echo "[1]: (1 && 0 && 1) = $"
)

#逻辑运算符 $
#等价于C++ if (condition || condition || ...) return "1" else return "0"
add_custom_command(
   TARGET MyExecutable PRE_BUILD
   COMMAND ${CMAKE_COMMAND} -E echo "[2]: (1 || 0 || 0) = $"
)

#逻辑运算符 $
#等价于C++ if (!condition) return "1" else return "0"
add_custom_command(
   TARGET MyExecutable PRE_BUILD
   COMMAND ${CMAKE_COMMAND} -E echo "[3]: !1 = $"
)

结果如下：