一、命令格式
configure_file(input output options)
将一个文件(由input参数指定)拷贝到指定位置(由output参数指定),并根据options修改其内容。
二、命令解析
configure_file命令一般用于自定义编译选项或者自定义宏的场景。configure_file命令会根据options指定的规则,自动对input文件中cmakedefine关键字及其内容进行转换。
具体来说,会做如下几个替换:
1. 将input文件中的@var@或者${var}替换成cmake中指定的值。
2. 将input文件中的#cmakedefine var关键字替换成#define var或者#undef var,取决于cmake是否定义了var。
三、举例说明
需要准备2个文件,config.h.in(input)、CMakeLists.txt,(output是自动生成的)内容如下:
config.h.in
#cmakedefine var1
#cmakedefine var2 "@var2@" #注意:@@之间的名称要与cmakedefine后的变量名一样
#cmakedefine var3 "${var3}" #注意:${}之间的名称要与cmakedefine后的变量名一样
#ifdef _@var4@_${var5}_
#endif
CMakeLists.txt
cmake_mininum_required(VERSION 2.8)
project (configure_file_test)
option (var1 "use var1..." ON) #定义var1,也可以使用cmake -Dvar1=ON替代
set (var2 13) #指定var2的值
set (var3 "var3string") #指定var3的值
set (var4 "VARTEST4")
set (var5 "VARTEST5")
configure_file (config.h.in config.h)
执行cmake命令
cmake .
自动生成的config.h文件内容
#define var1
#define var2 "13"
#define var3 "var3string"
#ifdef _VARTEST4_VARTEST5_
#endif
cmakedefine01命令
- #cmakedefine01 var
如果var有定义,则实际生成的效果为:#define var 1;如果var未定义,生成的效果为:#define var 0。
config.h.in文件:
#cmakedefine01 var
CMakeLists.txt文件:
option(var “use var…” ON) # 实际也可以用cmake -Dvar=ON或者cmake -Dvar=OFF来定义或者不定义
#set (var XXX) # 用set来定义var也可以,验证发现XXX为0的时候相当于var未定义,XXX为非0的时候效果相当于var有定义
生成的config.h文件:
#define var 1 # 当var有定义
#define var 0 # 当var未定义
其他注意事项
对于#cmakedefine var @var@或#cmakedefine var
v
a
r
,
@
@
之
间
或
{var},@@之间或
var,@@之间或{}内的变量名称要与cmakedefine后的变量名称一样,否则替换不成功。
configure_file要放在变量定义之后(验证发现OPTION定义的变量可以在configure_file之后)。