7.4 用指定参数定义函数或宏
Last updated
Was this helpful?
Last updated
Was this helpful?
NOTE:此示例代码可以在 中找到,其中包含一个C++示例。该示例在CMake 3.5版(或更高版本)中是有效的,并且已经在GNU/Linux、macOS和Windows上进行过测试。
前面的示例中,我们研究了函数和宏,并使用了位置参数。这个示例中,我们将定义一个带有命名参数的函数。我们将复用第1节中的示例,使用函数和宏重用代码,而不是使用以下代码定义测试:add_catch_test(short 1.5)
。
我们将这样调用函数:
我们使用第1节中的示例,使用函数和宏重用代码,并保持C++源代码不变,文件树保持不变:
我们对CMake代码进行一些修改,如下所示:
CMakeLists.txt
顶部中只增加了一行,因为我们将包括位于cmake
下面的模块:
保持src/CMakeLists.txt
。
tests/CMakeLists.txt
中,将add_catch_test
函数定义移动到cmake/testing.cmake
,并且定义两个测试:
add_catch_test
在cmake/testing.cmake
中定义:
测试输出:
最后,编译并测试:
示例的特点是其命名参数,因此我们可以将重点放在cmake/testing.cmake
模块上。CMake提供cmake_parse_arguments
命令,我们使用函数名(add_catch_test
)选项(我们的例子中是none
)、单值参数(NAME
和COST
)和多值参数(LABELS
、DEPENDS
和REFERENCE_FILES
)调用该命令:
cmake_parse_arguments
命令解析选项和参数,并在例子中定义如下:
add_catch_test_NAME
add_catch_test_COST
add_catch_test_LABELS
add_catch_test_DEPENDS
add_catch_test_REFERENCE_FILES
可以查询,并在函数中使用这些变量。这种方法使我们有机会用更健壮的接口和更具有可读的函数/宏调用,来实现函数和宏。
选项关键字(本例中我们没有使用)由cmake_parse_arguments
定义为TRUE
或FALSE
。add_catch_test
函数,还提供test
命令作为一个命名参数,为了更简洁的演示,我们省略了这个参数。
TIPS:cmake_parse_arguments
命令在cmake 3.5的版本前中的CMakeParseArguments.cmake
定义。因此,可以在CMake/test.cmake
顶部的使用include(CMakeParseArguments)
命令使此示例能与CMake早期版本一起工作。