介绍
CMake简介
CMake是一个开源的跨平台构建工具，它可用于生成可定制的构建过程，如Makefiles、Visual Studio项目或Xcode项目。CMake使用CMakeLists.txt文件来描述构建过程，这些文件包含了构建项目所需的信息，包括源代码、库、头文件和可执行文件等。
function和macro的概念
在CMake中，function和macro都是用来实现代码重用的工具。它们的主要区别在于参数传递和作用域。
function和macro都可以在CMakeLists.txt文件中定义和调用。在调用时，function和macro的参数传递方式不同。function的参数传递采用传值方式，而macro的参数传递采用文本替换方式。
另外，function和macro的作用域也有所不同。在CMake中，function的作用域是局部作用域，而macro的作用域是全局作用域。这意味着在function中定义的变量只在function中有效，而在macro中定义的变量则在整个CMakeLists.txt文件中有效。
使用function和macro，可以将一些常用的操作封装起来，比如生成安装目录、编译选项等。这样可以减少代码的重复性，提高代码的可维护性和可读性。
function
function的语法和用法
在CMake中，function是用来实现代码重用的工具。function的语法如下：
function(function_name arg1 arg2 ...) # function body endfunction()
其中，function_name是函数名，arg1、arg2等是函数的参数。在function的body中，可以使用CMake语句来实现具体的操作。
function的参数传递
function的参数传递采用传值方式。这意味着在调用function时，实参的值会被传递到形参中。例如：
function(add_numbers num1 num2) math(EXPR result "${num1} + ${num2}") message("The result is ${result}") endfunction() add_numbers(1 2)
在上面的例子中，add_numbers函数有两个参数num1和num2。在调用函数时，传递了实参1和2，这些实参的值会被传递到num1和num2中。
function的返回值
function可以有返回值，返回值可以通过set命令设置。例如：
function(add_numbers num1 num2) math(EXPR result "${num1} + ${num2}") set(${result_var} ${result} PARENT_SCOPE) endfunction() add_numbers(1 2 RESULT) message("The result is ${RESULT}")
在上面的例子中，add_numbers函数计算了num1和num2的和，并将结果通过set命令设置到了result_var变量中。在调用函数时，传递了实参1和2，并将返回值保存到了RESULT变量中。
示例代码
以下是一个示例函数，在CMakeLists.txt中定义了一个函数，用于生成一个静态库：
function(create_static_library LIBRARY_NAME SOURCE_FILES) add_library(${LIBRARY_NAME} STATIC ${SOURCE_FILES}) set_target_properties(${LIBRARY_NAME} PROPERTIES OUTPUT_NAME ${LIBRARY_NAME}) set_target_properties(${LIBRARY_NAME} PROPERTIES ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/lib) endfunction() set(SOURCE_FILES foo.cpp bar.cpp) create_static_library(my_library ${SOURCE_FILES})
在上面的示例代码中，create_static_library函数有两个参数LIBRARY_NAME和SOURCE_FILES。函数的作用是创建一个名为LIBRARY_NAME的静态库，其中包含了SOURCE_FILES中指定的文件。函数通过add_library命令创建了一个静态库，并通过set_target_properties命令设置了输出名称和输出路径。在调用函数时，传递了实参my_library和${SOURCE_FILES}变量。最终，create_static_library函数会生成一个名为my_library的静态库。
macro
Macro是CMake中的一种宏定义，可以将一些常用的代码片段定义为一个宏，当需要使用时直接调用宏即可，可以减少代码的重复性，提高代码的可读性和可维护性。
macro的语法和用法
宏定义的基本格式为：
macro(宏名 参数列表) 宏体 endmacro()
其中，宏名为标识符，参数列表为用括号括起来的形式参数列表，宏体为用endmacro()结束的宏定义体，宏名和宏体之间用空格隔开。
示例：
macro(PRINT_HELLO_WORLD) message("Hello World!") endmacro()
macro的参数传递
宏定义可以接受参数，参数传递方式类似于函数的参数传递，可以传递常量、变量或表达式等。参数传递的格式为：$(参数名)。
示例：
macro(PRINT_MESSAGE message) message(${message}) endmacro()
macro的变量作用域
宏定义中的变量作用域与函数中的变量作用域不同，宏定义中的变量作用域是在宏定义体内，即在宏定义体中定义的变量在宏体外无法访问。
示例：
cmake_minimum_required(VERSION 3.5) #定义一个宏，用于打印传入的消息和变量值 macro(PRINT_MESSAGE_AND_VALUE message value) #在当前宏中定义的变量，只在当前宏中有效 set(local_var "This is a local variable") message("${message}: ${value}") message("local_var: ${local_var}") endmacro() #定义一个全局变量 set(global_var "This is a global variable") #打印全局变量的值 message("global_var: ${global_var}") #调用宏，打印传入的消息和变量值 PRINT_MESSAGE_AND_VALUE("Print global_var" ${global_var}) #如果在宏中使用了外部定义的变量，需要在宏调用时将其传入 #调用宏，打印传入的消息和变量值，以及宏中定义的局部变量 PRINT_MESSAGE_AND_VALUE("Print local_var" "This is a parameter") #此处打印的local_var为空，因为它只在上面的宏中定义，在此处无法访问
示例代码
cmake_minimum_required(VERSION 3.5) #定义一个宏，用于打印"Hello world!" macro(PRINT_HELLO_WORLD) message("Hello World!") endmacro() #定义一个宏，用于打印传入的消息 macro(PRINT_MESSAGE message) message(${message}) endmacro() #定义一个宏，用于计算传入的两个数的最大值并打印 macro(PRINT_MAX a b) #定义一个变量max，并将其初值设置为a set(max ${a}) #如果b比max大，则将max的值设为b if(${b} GREATER ${a}) set(max ${b}) endif() #打印最大值 message("max=${max}") endmacro() #调用宏，打印"Hello world!" PRINT_HELLO_WORLD() #定义一个变量msg，并将其值设置为"Hello CMake!" set(msg "Hello CMake!") #调用宏，打印变量msg的值 PRINT_MESSAGE(${msg}) #调用宏，计算传入的两个数的最大值并打印 PRINT_MAX(10 20)
function和macro的区别
参数传递
function和macro在参数传递方面有所不同。在function中，参数传递是通过参数列表来完成的，参数有类型和顺序，类似于C语言函数的参数传递方式。而在macro中，参数传递是通过文本替换来完成的，因此参数没有类型和顺序限制，可以传递任何文本。
返回值
function可以有返回值，而macro没有返回值。在function中，可以使用return语句返回值，返回值的类型可以是任何CMake支持的类型。而在macro中，不能使用return语句返回值，因为macro的返回值是通过文本替换来实现的。
变量作用域
变量作用域： function和macro在变量作用域方面也有所不同。在function中，变量的作用域是函数内部，函数外部无法访问函数内部定义的变量。而在macro中，变量的作用域是整个CMake文件，因此可以在文件中的任何地方访问和修改宏中定义的变量。
代码示例
以下是一个使用function和macro实现同样功能的示例代码：
#使用function实现 function(ADD_ONE num) math(EXPR result "${num} + 1") return(${result}) endfunction() #调用function，将10加1，并将结果赋值给变量res ADD_ONE(10 res) message("Result: ${res}") #使用macro实现 macro(ADD_ONE num) math(EXPR result "${num} + 1") set(${ARGV1} ${result}) endmacro() #调用macro，将10加1，并将结果赋值给变量res ADD_ONE(10 res) message("Result: ${res}")
在这个示例中，我们实现了将一个数加1的功能，使用function和macro两种方式分别实现。可以看出，function使用return语句返回结果，而macro使用set命令将结果赋值给一个参数。另外，调用方式也有所不同，function使用函数调用的方式，而macro使用文本替换的方式。
function和macro的优缺点以及使用场景
- function的优点：
参数传递和返回值更加灵活，可以实现复杂的逻辑处理；
变量作用域仅限于函数内部，避免了变量命名冲突的问题；
可以使用递归调用实现复杂的算法；
在CMake文件中调用function更加直观，易于理解。
- function的缺点：
由于使用return语句返回结果，因此会创建新的变量，占用额外的内存空间；
递归调用会导致堆栈溢出的问题；
由于函数调用需要额外的资源开销，因此在处理大量数据时可能会影响性能。
- macro的优点：
参数传递更加灵活，可以传递任意文本；
可以直接修改CMake文件中的变量，更加方便；
在处理大量数据时性能更好，因为不需要额外的资源开销。
- macro的缺点：
由于使用文本替换，因此不能实现复杂的逻辑处理；
变量作用域是整个CMake文件，容易出现变量命名冲突的问题；
不能使用递归调用。
- function的使用场景：
实现复杂的逻辑处理；
需要递归调用的场景；
在CMake文件中调用function更加直观，易于理解。
- macro的使用场景：
实现简单的文本替换；
需要直接修改CMake文件中的变量的场景；
在处理大量数据时性能更好的场景。
综上所述，function和macro各有优缺点，在不同的场景下选择适合的方法可以使CMake的使用更加高效和方便。
总结
在这篇博客中，我们将详细介绍CMake中function和macro的概念、语法和用法，并通过示例代码演示它们的使用。我们还将比较function和macro之间的区别，并讨论它们在实际应用中的使用场景和最佳实践。
通过本文的学习，读者将能更好地理解和应用CMake中的function和macro，提高代码的可重用性和可维护性。
