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

【写在前面】

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

        本文引用的文档链接:

cmake 生成器表达式 (7) — CMake 3.26.4 Documentationhttps://cmake-doc.readthedocs.io/zh-cn/latest/manual/cmake-generator-expressions.7.html#debugging


 【正文开始】

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

  • 条件表达式:

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

        $<condition:true_string>

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

        $<IF:condition,true_string,false_string>

在 3.8 版本加入.

如果“条件”为“1”,则评估为“true_string”,如果“条件”为“0”,则评估为“false_string”。 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 是不区分大小写的等于 0FALSEOFFNNOIGNORE 或 ` NOTFOUND` 或

  • string 以后缀 -NOTFOUND 结尾(区分大小写)。

否则计算为“1”。

        当 CMake 变量提供“条件”时,经常使用“$<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”。如果“条件”中的至少一个为“1”,则整个表达式的计算结果为“1”。如果所有“条件”的计算结果为“0”,则整个表达式的计算结果为“0”。

        $<NOT:condition>

condition 必须是 0 或 1。如果“条件”为“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/LearnCMakehttps://github.com/mengps/LearnCMake

上一篇:报错解决:opene3d draw_geometries: incompatible function arguments.-1. 报错信息


下一篇:[含文档+PPT+源码等]精品基于PHP实现的培训机构信息管理系统的设计与实现