<<Modern CMake>> 翻译 2.2 CMake 编程
<<Modern CMake>> 翻译 2.2 CMake 编程
流程控制
CMake有一个 if
语句, 经年累月之后,现在它已经相当复杂。 您可以在 if
语句中使用全大写字母书写一系列关键字,并且您通常可以直接通过名称(if语句在历史上出现早于变量扩展)或使用 ${}
语法来引用变量。 下面是 if
语句的示例:
if(variable)
# If variable is `ON`, `YES`, `TRUE`, `Y`, or non zero number
else()
# If variable is `0`, `OFF`, `NO`, `FALSE`, `N`, `IGNORE`, `NOTFOUND`, `""`, or ends in `-NOTFOUND`
endif()
# If variable does not expand to one of the above, CMake will expand it then try again
如果您明确地进行变量扩展(例如 ${variable}
,由于扩展的潜在扩展),这可能会有点混乱。 在CMake 3.1+ 中添加了一个策略(CMP0054),使得被引号引起来的变量扩展不被递归扩展。 因此,只要 CMake 的最低版本是 3.1+,您就可以:
if("${variable}")
# True if variable is not false-like
else()
# Note that undefined variables would be `""` thus false
endif()
这里还有一些可以在 if
命令中使用的关键字,例如:
- 一元关键字:
NOT
,TARGET
,EXISTS
(文件),DEFINED
, 等等 - 二元关键字:
STREQUAL
,AND
,OR
,MATCHES
(正则表达式),VERSION_LESS
,VERSION_LESS_EQUAL
(CMake 3.7+), 等等 - 括号可以用于分组
生成器表达式 (Generator-expressions)
Generator-expressions 非常强大,但也有点奇怪和专业。 大多数 CMake 命令在配置时运行,包括上面看到的 if
语句。 但是如果你需要在构建时甚至安装时间执行逻辑呢? 为了这个目的 CMake 添加了生成器表达式(Generator-expressions)。1 它们在目标属性中进行计算和执行。
最简单的生成器表达式是信息表达式,具有这样 $<KEYWORD>
的形式; 他们评估(计算和执行)一条与当前配置相关的信息。 另一种形式是 $<KEYWORD:value>
,KEYWORD 关键字控制评估,value
是要评估的项目(这里也允许使用信息表达式关键字)。 如果 KEYWORD
是一个计算结果为 0 或 1 的生成器表达式或变量,value
则替换为 0 或 1。 您可以嵌套生成器表达式,并且可以使用变量来使嵌套变量可读。 某些表达式允许使用逗号分隔的多个值。2
例如,如果你想要设置仅在 DEBUG
配置下生效的编译标志,则可以这样写:
target_compile_options(MyTarget PRIVATE "$<$<CONFIG:Debug>:--my-flag>")
这是一种比使用专用 *_DEBUG
变量更新,更好的方式,并且可以推广到生成器表达式支持的所有情况。 请注意,您永远不应该使用配置时的值作为当前配置,因为 IDE 之类的多配置生成器并没有“当前”配置,仅在构建时通过生成器表达式和自定义的 *_<CONFIG>
变量起作用。
生成器表达式的其他常见用法:
- 将项目限制为仅限某种语言(例如 CXX),以避免它与 CUDA 等混在一起,或者根据目标语言将其包装以使其不同。
- 访问配置相关属性,例如目标文件位置。
- 为构建和安装目录提供不同的位置。
最后一个很常见。几乎每个支持安装的软件包都会看到类似的内容:
target_include_directories(
MyTarget
PUBLIC
$<BUILD_INTERFACE:"${CMAKE_CURRENT_SOURCE_DIR}/include">
$<INSTALL_INTERFACE:include>
)
1. 它们就像在构建/安装时评估它们一样,但实际上它们是针对每个构建配置分别进行评估的。↩
2. CMake 文档将表达式拆分为信息,逻辑和输出。↩
宏和函数
你可以方便的定义你自己的 CMake 函数 function
和宏 macro
。 函数和宏之间的唯一区别是作用范围:宏没有作用范围。 因此,如果您在函数中设置了变量并希望它在外部可见,那么您将需要用 PARENT_SCOPE
。 由于您必须在每个函数中明确用 PARENT_SCOPE
设置您希望外部世界可见的变量,嵌套函数有点儿烦。 但是,函数不会像宏一样 “泄漏” 变量。 在以下示例中,我将使用函数。
一个简单使用函数的例子如下:
function(SIMPLE REQUIRED_ARG)
message(STATUS "Simple arguments: ${REQUIRED_ARG}, followed by ${ARGV}")
set(${REQUIRED_ARG} "From SIMPLE" PARENT_SCOPE)
endfunction()
simple(This)
message("Output: ${This}")
如果你想用位置参数,它们需要明确列出,并且所有其他参数都被放在 ARGN
中(ARGV
中保存有所有参数,甚至那些你已经列出的参数)。 您只能通过设置变量来解决 CMake 中函数没有返回值的问题。 在上面的示例中,您可以显式指定要设置的变量名称。
参数
你已经在 CMake 函数的大部分使用中看到,CMake 有一个命名变量系统。 您可以将它与 cmake_parse_arguments
函数一起使用。 如果要支持 3.5 以下的 CMake 版本,您还需要包含 CMakeParseArguments 模块,该模块在成为内置命令之前就已存在。
以下是如何使用它的示例:
function(COMPLEX)
cmake_parse_arguments(
COMPLEX_PREFIX
"SINGLE;ANOTHER"
"ONE_VALUE;ALSO_ONE_VALUE"
"MULTI_VALUES"
${ARGN}
)
endfunction()
complex(SINGLE ONE_VALUE value MULTI_VALUES some other values)
在此调用 cmake_parse_arguments
函数后,在 complex
函数内部,给我们产生了这些变量:
COMPLEX_PREFIX_SINGLE = TRUE
COMPLEX_PREFIX_ANOTHER = FALSE
COMPLEX_PREFIX_ONE_VALUE = "value"
COMPLEX_PREFIX_ALSO_ONE_VALUE = <UNDEFINED>
COMPLEX_PREFIX_MULTI_VALUES = "some;other;values"
如果你查看官方页面,你会看到一个稍微不同的使用 set
的方法避免在列表中明确写分号的方法; 随意使用您最喜欢的结构。 您也可以将它与上面列出的位置参数混合使用; 任何剩余的参数(包括可选的位置参数)都会保存在 COMPLEX_PREFIX_UNPARSED_ARGUMENTS
中。
<<Modern CMake>> 翻译 2.2 CMake 编程的更多相关文章
- <<Modern CMake>> 翻译 2. CMake 基础
<<Modern CMake>> 翻译 2. CMake 基础 最低版本 这是每个 CMakeLists.txt 文件的第一行.CMakeLists.txt 是 CMake 所 ...
- <<Modern CMake>> 翻译 1. CMake 介绍
<<Modern CMake>> 翻译 1. CMake 介绍 人们喜欢讨厌构建系统. 仅仅观看 CppCon17 上的演讲,就可以看到开发人员因为构建系统而闹笑话的例子. 这 ...
- <<Modern CMake>> 翻译 2.3 与代码通信
<<Modern CMake>> 翻译 2.3 与代码通信 配置文件 CMake 允许您使用代码通过 configure_file 存取 CMake 变量. 此命令复制一个文件 ...
- <<Modern CMake>> 翻译 2.4 项目目录结构
<<Modern CMake>> 翻译 2.4 项目目录结构 本节内容有点跑题.但我认为这是一个很好的方法. 我将告诉你如何规划项目的目录. 这是基于惯例,但将帮助您: 轻松阅 ...
- Effective Modern C++翻译(1):序言
/*********************************************************** 关于书: 书是我从网上找到的effective Modern C++的样章,内 ...
- mysql配置文件夹错误:在安装mysql 5.6.19 时运行cmake命令是出现CMake Error: The source directory does not appear to contai
在安装mysql 5.5.xx 时运行cmake命令是出现CMake Error: The source directory does not appear to contain CMakeLists ...
- cmake之譬判断cmake的版本
note 有时候,可能使用的cmake语法 与cmake的版本有关系, 比如modern cmake. 这时候我们可以在 CMAKELISTS.TXT中 判断 cmakeLists.txt 代码 if ...
- 源码安装cmake(或者叫升级cmake)
cmake source install as follows: 0 cd ~ 1 wget https://cmake.org/files/v3.5/cmake-3.5.2.tar.gz 2 tar ...
- [书籍翻译] 《JavaScript并发编程》第一章 JavaScript并发简介
> 本文是我翻译<JavaScript Concurrency>书籍的第一章,该书主要以Promises.Generator.Web workers等技术来讲解JavaScript并 ...
随机推荐
- CMake编译如何解决[-Werror,-Wformat-security] 问题
在用Android Studio进行Android开发时,常常采用 java代码调用C++代码,即JNI调用native的开发模式. 在上层build.gradle编译脚本里面可以指定C++代码的编译 ...
- Ajax中post与get的区别
get和post都是向服务器发送一种请求,只是发送机制不同 . 1. GET可以通过在请求URL上添加请求参数, 而POST请求则是作为HTTP消息的实体内容发送给WEB服务器. 2. get方式请求 ...
- 分布式流处理框架 Apache Storm —— 编程模型详解
一.简介 二.IComponent接口 三.Spout 3.1 ISpout接口 3.2 BaseRichSpout抽象类 四.Bolt 4.1 IBolt 接口 4. ...
- 20 如何通过pycharm快速的创建一个html页面
1.打开pycharm并且新建一个html页面,如下图所示. 2.删除html页面中默认的内容,之后在页面中输入!,之后点击tab即可完成一个html页面的框架新增.
- Hive 学习之路(三)—— Hive CLI和Beeline命令行的基本使用
一.Hive CLI 1.1 Help 使用hive -H或者 hive --help命令可以查看所有命令的帮助,显示如下: usage: hive -d,--define <key=value ...
- chmod命令用法详解-chmod修改目录权限
chmod用法: 用来修改某个目录或文件的访问权限. 语法: chmod [-cfvR] [--help] [--version] [who] [+ | - | =] [mode] 文件名 例子: ...
- 浅谈C#泛型
一.为什么要提出泛型的概念 我们在声明对象或者方法中,对象中成员变量的定义或者函数参数都传递都要指定具体的对象类型,但是有的时候参数的类型是变化的,但是实现的功能却又差不多,这个时候我们就想,是否存在 ...
- 201907 TIOBE 编程语言排行榜-Python坐稳第三
目录 一.编程语言7月排行榜 二.Top10编程语言指数走势(2002-2018) 三.历史排名(1988-2019) 四.编程语言"名人榜"( 2003-2018) 五.Top2 ...
- 正确写网站title、keywords、description
一.title title,也就是标题,是在浏览器上面显示出来的,方便用户了解这个页面的内容;特别是搜索引擎判断你网页内容的主要根据.搜索引擎就很大部分是依靠网站title来判断你网站是关于什么内容的 ...
- JAVA String类型的一些小操作
String类型是否包含某个String类型的函数:源字符串.contains(包含字符串) 返回值为:boolean类型(true或false) String类型把某个字符替换成另一个字符:源字符 ...