CMAKE——message()函数

本文详细介绍了CMake中message命令的使用方法,包括如何输出不同类型的提示信息,如STATUS、WARNING、FATAL_ERROR等,并展示了具体的代码示例。了解这些信息有助于开发者在构建过程中更好地控制和理解CMake的行为。

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

message :为用户显示一条消息。


 message( [STATUS|WARNING|AUTHOR_WARNING|FATAL_ERROR|SEND_ERROR]
  "message to display" ...)


 可以用下述可选的关键字指定消息的类型:

(无) = 重要消息;
 STATUS = 非重要消息;
 WARNING = CMake 警告, 会继续执行;
 AUTHOR_WARNING = CMake 警告 (dev), 会继续执行;
 SEND_ERROR = CMake 错误, 继续执行,但是会跳过生成的步骤;
 FATAL_ERROR = CMake 错误, 终止所有处理过程;


 CMake 的命令行工具会在 stdout 上显示 STATUS 消息,在 stderr 上显示其他所有消息。
CMake 的 GUI 会在它的 log 区域显示所有消息。交互式的对话框(ccmake 和 CMakeSetup)
将会在状态行上一次显示一条 STATUS 消息,而其他格式的消息会出现在交互式的弹出式对话
框中。
 CMake 警告和错误消息的文本显示使用的是一种简单的标记语言。文本没有缩进,超过长
度的行会回卷,段落之间以新行做为分隔符。

 


1.输出错误 FATAL_ERROR

message(FATAL_ERROR "
FATAL: In-source builds are not allowed.
       You should create a separate directory for build files.
")

2.输出警告 WARNING

message(WARNING "OpenCV requires Android SDK tools revision 14 or newer.")

  

3.输出正常 STATUS

message(STATUS "Can't detect runtime and/or arch")


 

### CMake 中 `cmake.func` 的用法及相关信息 在 CMake 中,并不存在名为 `cmake.func` 的内置命令或标准模块[^1]。然而,CMake 提供了一种机制,允许用户通过自定义函数(function)和宏(macro)来自行扩展其功能集。这可能是您提到的 `cmake.func` 实际所指的内容。 #### 用户自定义函数 CMake 支持用户定义自己的函数和宏以便重复使用代码片段或者封装复杂逻辑。这些自定义函数通常被保存在一个单独的 `.cmake` 文件中并可通过 `include()` 命令引入到主 `CMakeLists.txt` 文件当中[^2]。 ##### 定义一个简单的函数示例: ```cmake # 定义一个新的函数叫做 'my_custom_function' function(my_custom_function ARG1 ARG2) message(STATUS "Argument 1 is: ${ARG1}") message(STATUS "Argument 2 is: ${ARG2}") # 在这里可以放置任何合法的 cmake 指令... endfunction() # 调用刚才定义好的函数 my_custom_function("ValueOne" "ValueTwo") ``` 在这个例子里面展示了怎样去创建以及调用一个基本的 CMake 函数。注意参数传递给函数的方式是非常直接明了的——只需简单列举出来即可[^3]。 如果确实存在某个具体项目的 `cmake.func` 文件,则它很可能是该项目内部维护的一个脚本文件,包含了若干辅助性的函数定义。要了解它的确切用途,就需要查阅该特定项目文档或是源码中的实际实现细节。 #### 查阅已有的函数/命令帮助信息 对于官方支持的标准指令而言,可以直接借助如下两种途径获取权威的帮助资料: 1. **在线手册页查询**:访问 [https://cmake.org/cmake/help/latest/manual/cmake-commands.7.html](https://cmake.org/cmake/help/latest/manual/cmake-commands.7.html),这是最新版 CMake 所提供全部公共接口列表页面; 2. **本地终端交互模式求助**:假如已经安装好 CMake 工具链,在 shell 终端输入类似下面这样的命令可以获得即时指导提示: ```bash cmake --help-command add_executable ``` 但是再次强调一遍,“cmake.func” 并不属于上述任一类预设范畴之内;如果是第三方插件或者是个人开发环境特制产物的话,那么具体情况还得参照对应上下文中给出的确切描述为准[^4]。 --- ###
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值