CMake命令之function

定义一个可在CMake脚本其他位置调用的函数。

function(<name>[arg1 [arg2 [arg3 ...]]])
    COMMAND1(ARGS ...)
    COMMAND2(ARGS ...)
    ...

endfunction(<name>)

 

定义一个函数名为<name>，参数名为arg1 arg2 arg3(…)。 函数体内的命令直到函数被调用的时候才会去执行。其中ARGC变量表示传递给函数的参数个数。 ARGV0, ARGV1, ARGV2代表传递给函数的实际参数。 ARGN代表超出最后一个预期参数的参数列表，例如，函数原型声明时，只接受一个参数，那么调用函数时传递给函数的参数列表中，从第二个参数（如果有的话）开始就会保存到ARGN。

测试实例：

[plain] view plaincopy

1. cmake_minimum_required(VERSION 2.8)  
2.   
3.   
4.   
5. project(ArgumentExpansion)  
6.   
7.   
8.   
9. function (argument_tester arg)  
10.     message(STATUS "ARGN: ${ARGN}")  
11.     message(STATUS "ARGC: ${ARGC}")  
12.     message(STATUS "ARGV: ${ARGV}")  
13.     message(STATUS "ARGV0: ${ARGV0}")  
14.   
15.     list(LENGTH ARGV  argv_len)  
16.     message(STATUS "length of ARGV: ${argv_len}")  
17.     set(i 0)  
18.     while( i LESS ${argv_len})  
19.          list(GET ARGV ${i} argv_value)  
20.          message(STATUS "argv${i}: ${argv_value}")  
21.   
22.          math(EXPR i "${i} + 1")  
23.     endwhile()  
24.   
25.   
26. endfunction ()  
27.   
28.   
29.   
30. argument_tester(arg0 arg1 arg2 arg3)  

运行结果：

-- ARGN: arg1;arg2;arg3
-- ARGC: 4
-- ARGV: arg0;arg1;arg2;arg3
-- ARGV0: arg0
-- ARGV1: arg1
-- length of ARGV: 4
-- argv0: arg0
-- argv1: arg1
-- argv2: arg2
-- argv3: arg3