CMAKE——set()函数及常用变量名

本文介绍CMake中的set()函数,用于设置变量的值,详细解析了CACHE选项及其类型,以及如何影响CMake GUI。同时,讨论了PARENT_SCOPE选项的作用,以及如何设置环境变量。通过示例,展示了设置全局变量的方法和判断环境变量是否定义的操作。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

 set : 将一个 CMAKE 变量设置为给定值。
 set( <variable>   <value>  [[CACHE  <type>  <docstring>  [FORCE]]  |  PARENT_SCOPE])


 将变量<variable>的值设置为<value>。在<variable>被设置之前,<value>会被展开。
如果有 CACHE 选项,那么<variable>就会添加到 cache 中;这时<type>和<docstring>是必需的。

<type>被 CMake GUI 用来选择一个窗口,让用户设置值。<type>可以是下述值中的一个:

 FILEPATH = 文件选择对话框。
 PATH = 路径选择对话框。
 STRING = 任意的字符串。
 BOOL = 布尔值选择复选框。
 INTERNAL = 不需要 GUI 输入端。(适用于永久保存的变量)。

 如果<type>是内部的(INTERNAL),那么<value>总是会被写入到 cache 中,并替换任何已经存在于 cache 中的值。

如果它不是一个 cache 变量,那么这个变量总是会写入到当前的makefile 中。FORCE 选项将覆盖 cache 值,从而去掉任何用户带来的改变。
 如果指定了 PARENT_SCOPE 选项,变量<variable>将会被设置为当前作用域之上的作用域中。每一个新的路径或者函数都可以创建一个新作用域。该命令将会把一

### 创建和使用自定义别名 在CMake中,可以通过`function()`来创建类似于其他编程语言中的函数或宏的概念,这可以被视作一种实现命令别名的方式。这种方式允许封装一系列复杂的操作到一个简单的名称下,在后续的CMake脚本编写过程中重复调用这个简单名称即可执行这些复杂操作。 #### 定义自定义命令别名 为了简化某些常用任务的操作流程,可以利用 `function()` 来定义新的命令别名: ```cmake # 自定义别名示例:用于打印消息并设置变量值 function(set_and_print_variable VAR_NAME VALUE) set(${VAR_NAME} ${VALUE} PARENT_SCOPE) # 设置父作用域内的变量 message(STATUS "${VAR_NAME} is now ${VALUE}") endfunction() ``` 上述代码片段展示了如何定义一个新的名为 `set_and_print_variable` 的命令别名[^1]。此命令接受两个参数作为输入——目标变量的名字以及要赋予该变量的新值;接着会更新指定变量并将新旧值的信息输出给用户查看。 #### 使用自定义命令别名 一旦定义好了这样的别名之后就可以像下面这样方便地在整个项目里边多次重用了: ```cmake set_and_print_variable(MY_VAR "Hello, world!") # 调用自定义命令别名 message(STATUS "The value of MY_VAR: ${MY_VAR}") # 输出变量的内容验证其已被正确赋值 ``` 这段例子说明了怎样去调用之前所定义好的 `set_and_print_variable` 函数,并传入具体的参数完成特定的任务逻辑[^2]。 需要注意的是虽然这里展示的例子相对比较简单直观,但在实际开发当中可以根据需求设计更为复杂的功能模块供整个团队成员共享使用,从而提高工作效率减少冗余代码量的同时也增强了可读性和维护性。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值