cmake_第二章 CMake基础语法_cmake列表命令list()，字符串string()和aux_source_directory()

本文介绍cmake列表命令list()，字符串string()和aux_source_directory()

第二章 CMake基础语法

2.6 CMake列表命令list()

虽然CMake 中的所有值都存储为字符串，但在某些上下文中字符串可能会被视为列表，CMake列表使用分号 ; 进行分隔。
例如set(VAR a.c b.c c.c)实际上是保存为了列表“a.c;b.c;c.c”.

2.6.1 list语法

语法规则：

list(<subcommand><list-variable>[<args>...])<subcommand>: 必须指定的操作类型（如 APPEND, GET, LENGTH 等）。<list-variable>: 变量名（注意：这里传的是变量的名字 num，而不是变量的值${num}）。[<args>...]: 该子命令所需的参数（如要添加的值、索引等）。

子命令：

LENGTH 返回列表的长度 GET 获取列表指定下标位置的元素 APPEND 在列表末尾添加元素 PREPEND 在列表头部添加元素 INSERT 将元素插入到列表的指定索引处。索引超出范围会引起错误； POP_BACK 如果未给出变量名称，则仅删除最后一个元素。否则提供N个变量名称，删除最后N 个赋给相应变量 POP FRONT 如果未给出变量名称，则仅删除最前一个元素。否则提供N 个变量名称，删除最前N 个赋给相应变量 REMOVE AT 从列表中删除给定索引处的项目。 REMOVE ITEM 从列表中删除给定项目的所有实例。 REMOVE DUPLICATES 删除列表中的重复项目。保留项目的相对顺序，但如果遇到重复项则仅保留第一个实例。 SORT 按字母顺序对列表进行就地排序。

2.6.2 测试 list 子命令用法

list.cmake 脚本文件

2.6.2.1 message加引号和不加引号区别

cmake_minimum_required(VERSION3.11)# 定义变量：变量名字区分大小写set(NUMS12345)message(${NUMS})#12345message("NUMS = ${NUMS}")# NUMS=1;2;3;4;5

可以看出，如果在Message中加上 " "，输出的字符串就会以 ; 分割；
【记住：加了引号多输出; 不加引号少输出 】

2.6.2.2 测试list子命令

cmake_minimum_required(VERSION3.11)# 定义变量：变量名字区分大小写set(NUMS12345)message(${NUMS})# 12345message("NUMS =${NUMS}")# NUMS = 1;2;3;4;5# 可以看出，如果在Message中加上 " "，输出的字符串就会以 ; 分割# 1、测试字符串(set(NUMS 1 2 3 4 5))长度list(LENGTH NUMS LEN)message("LEN =${LEN}")# LEN = 5# 2、GET 获取列表指定索引的元素list(GET NUMS3FIRST)# 获取第X个索引的元素message("FIRST =${FIRST}")# FIRST = 4# 3、APPEND 在列表末尾添加元素list(APPEND NUMS6)# 在列表末尾添加元素message("NUMS =${NUMS}")# NUMS = 1;2;3;4;5;6# 4、PREPEND 在列表头部插入元素list(PREPEND NUMS"first")message("NUMS =${NUMS}")# NUMS = first;1;2;3;4;5;6# 5、INSERT 在列表指定位置插入元素list(INSERT NUMS3"insert")# 在列表第3个位置插入元素message("NUMS =${NUMS}")# NUMS = first;1;2;insert;3;4;5;6# 6、REMOVE_AT 从列表中删除指定索引的元素list(REMOVE_AT NUMS3)# 删除列表第3个位置的元素message("NUMS =${NUMS}")# NUMS = first;1;2;3;4;5;6# 7、SORT 排序list(SORT NUMS)message("NUMS =${NUMS}")# NUMS = 1;2;3;4;5;6;first# 8 删除最后一个元素list(POP_BACK NUMS)message("NUMS =${NUMS}")# NUMS = 1;2;3;4;5;6

2.7 CMake字符串命令string()

cmake 使用string()命令来操作字符串。

string(子命令 参数 …)子命令如下： LENGTH 返回字符串的长度 TOLOWER 将字符串转换为小写 TOUPPER 将字符串转换为大写 APPEND 在字符串末尾添加字符串 PREPEND 在字符串头部添加字符串 SUBSTRING 获取子字符串 STRIP 删除字符串前后的空格 CONCAT 将多个字符串连接在一起 FIND 查找一个字符串的索引位置 REPLACE 将字符串替换为给定字符串 REGEX MATCH 查找匹配一次正则表达式匹配的内容 REGEX MATCHALL 查找匹配全部正则表达式匹配的内容 REGEX REPLACE 替换匹配全部正则表达式匹配的内容 ASCII 将所有数字转换为相应的 ASCII 字符. HEX 将 ASCII 字符转换为十六进制数字

测试 string.cmake文件源码

cmake_minimum_required(VERSION3.11)# 定义一个字符串set(MyString"Hello World")message("原始字符串内容为：MyString =${MyString}")# MyString = Hello World# 测试字符串子命令# 字符串长度string(LENGTH${MyString}MyStringLength)message("MyStringLength =${MyStringLength}")# MyStringLength = 8# 字符串转为大写 MyStringUpper = MYSTRINGstring(TOUPPER${MyString}MyStringUpper)message("大写 MyString =${MyStringUpper}")# MyString = HELLO WORLD# 在字符串末尾添加元素string(APPEND MyString"!!")message("${MyString}")# Hello World!!# 获取子串，从索引2开始，长度为3为的子串，存放在substring中string(SUBSTRING${MyString}23substring)message("substring=${substring}")# substring=llo# 删除前后空格set(spacestring" hello world ")string(STRIP${spacestring}stripstring)message("stripstring=${stripstring}")# stripstring=hello world# 连接多个字符串set(str1"hello")set(str2" 你好")string(CONCAT str3${str1}${str2})message(str3=${str3})# str3=hello 你好# 查找字符串: 如果查找成功返回字符串索引，否则返回-1string(FIND${MyString}"World"index)message("index=${index}")# index=6# 查找正则表达式匹配内容set(s"a 1 a2 3a a456b")string(REGEX MATCHALL"a[0-9]+"result${s})# 匹配任意多个a+数字message("result=${result}")# result=a2;a456# 将数字转为ASCIIstring(ASCII65v)message("v=${v}")# v=A#将ASii码转换为十六进制string(HEX"A"v)message("HEX=${v}")# HEX=41

2.8 aux_source_directory()命令搜索目录下源文件

假设我们的项目中有很多源文件，那么来使用add_executable()添加可执行文件时，需要一个一个指定源文件，岂不是很麻烦? 比如有 a.c b.c c.c d.c e.c 那么使用add_executable(appexe a.c b.c c.c d.c e.c …) 这样一个一个添加，文件多时，添加文件就很麻烦了，有没有简单方法，一次性获取这么多文件呢？

2.8.1 自动搜索源文件

auxiliary 辅助的，使用aux_source_directory() 查找目录中(不包含子目录)的所有源文件,当向目录添加新文件时，必须手动重新运行 CMake 以生成包含新文件的构建系统。
语法格式：

aux_source_directory(<dir><variable>)dir指定要搜索的目录，比如当前目录,.variable 将查找到的源文件列表放到此变量中

2.8.2 测试

目录如下，有多个源文件和头文件，下面的目录中分别当前目录和子目录，寻找源文件和头文件。

cmake_minimum_required(VERSION3.14)project(testauxSourceDirectory)aux_source_directory(. DIR_SRCS)message(DIR_SRCS=${DIR_SRCS})# DIR_SRCS=./a.c ./b.c ./c.c ./d.c ./e.cc ./f.cpp ./g.cxx ./h.Caux_source_directory(./sub SUB_SRCS)message(SUB_SRCS=${SUB_SRCS})# SUB_SRCS=./sub/dd.c