CMake 生成器表达式---条件表达式和逻辑运算符

【写在前面】

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

本文引用的文档链接：

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

---

【正文开始】

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

• 条件表达式：

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

$<condition:true_string>

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

$<IF:condition,true_string,false_string>

在 3.8 版本加入.

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

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

$<$<CONFIG:Debug>:DEBUG_MODE>

使用示例：

#条件表达式 $<condition:true_string>
#等价于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>"
)

#条件表达式 $<IF:condition,true_string,false_string>
#等价于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} | $<IF:${IS_DEBUG},is debug,is release>"
)

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

$<BOOL:string>

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

• string 为空，

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

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

否则计算为“1”。

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

$<$<BOOL:${HAVE_SOME_FEATURE}>:-DENABLE_SOME_FEATURE>

使用示例：

#条件表达式 $<BOOL:string>
#等价于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} | $<BOOL:${STRING2BOOL}> | $<$<BOOL:${STRING2BOOL}>:STRING2BOOL is not empty>"
)

三个示例的输出如下：

• 逻辑运算符

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

 $<AND:conditions>

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

$<OR:conditions>

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

$<NOT:condition>

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

使用示例：

#逻辑运算符 $<AND:conditions>
#等价于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) = $<AND:1,0,1>"
)

#逻辑运算符 $<OR:conditions>
#等价于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) = $<OR:1,0,0>"
)

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

结果如下：

---

【结语】

项目链接(多多star呀.._)：

Github 地址：https://github.com/mengps/LearnCMake

​