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

文章目录

[第二章 CMake基础语法](#第二章 CMake基础语法)
- [2.6 CMake列表命令list()](#2.6 CMake列表命令list())
- - [2.6.1 list语法](#2.6.1 list语法)
  - [2.6.2 测试 list 子命令用法](#2.6.2 测试 list 子命令用法)
  - - [2.6.2.1 message加引号和不加引号区别](#2.6.2.1 message加引号和不加引号区别)
    - [2.6.2.2 测试list子命令](#2.6.2.2 测试list子命令)
- [2.7 CMake字符串命令string()](#2.7 CMake字符串命令string())
- [2.8 aux_source_directory()命令搜索目录下源文件](#2.8 aux_source_directory()命令搜索目录下源文件)
- - [2.8.1 自动搜索源文件](#2.8.1 自动搜索源文件)
  - [2.8.2 测试](#2.8.2 测试)

本文介绍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语法

语法规则：

bash 复制代码

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

子命令：

bash 复制代码

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加引号和不加引号区别

c 复制代码

cmake_minimum_required(VERSION 3.11)

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

可以看出，如果在Message中加上 " "，输出的字符串就会以 ; 分割；

【记住：加了引号多输出; 不加引号少输出】

2.6.2.2 测试list子命令

bash 复制代码

cmake_minimum_required(VERSION 3.11)

# 定义变量：变量名字区分大小写
set(NUMS 1 2 3 4 5)
message(${NUMS}) # 12345
message("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 NUMS 3 FIRST)
# 获取第X个索引的元素 
message("FIRST = ${FIRST}") # FIRST = 4

# 3、APPEND 在列表末尾添加元素
list(APPEND NUMS 6) # 在列表末尾添加元素
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 NUMS 3 "insert") # 在列表第3个位置插入元素
message("NUMS = ${NUMS}") # NUMS = first;1;2;insert;3;4;5;6

# 6、REMOVE_AT 从列表中删除指定索引的元素
list(REMOVE_AT NUMS 3) # 删除列表第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()命令来操作字符串。

bash 复制代码

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

测试 string.cmake文件源码

bash 复制代码

cmake_minimum_required(VERSION 3.11)

# 定义一个字符串
set(MyString "Hello World")
message("原始字符串内容为：MyString = ${MyString}") 
# MyString = Hello World

# 测试字符串子命令
# 字符串长度
string(LENGTH ${MyString} MyStringLength)
message("MyStringLength = ${MyStringLength}") 
# MyStringLength = 8

# 字符串转为大写 MyStringUpper = MYSTRING
string(TOUPPER ${MyString} MyStringUpper)
message("大写 MyString = ${MyStringUpper}") 
# MyString = HELLO WORLD

# 在字符串末尾添加元素
string(APPEND MyString "!!")
message("${MyString}") # Hello World!! 

# 获取子串，从索引2开始，长度为3为的子串，存放在substring中
string(SUBSTRING ${MyString}  2  3 substring)
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 你好

# 查找字符串: 如果查找成功返回字符串索引，否则返回-1
string(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

# 将数字转为ASCII  
string (ASCII 65 v)
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 以生成包含新文件的构建系统。

语法格式：

bash 复制代码

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

2.8.2 测试

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

bash 复制代码

cmake_minimum_required(VERSION 3.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.C

aux_source_directory(./sub SUB_SRCS)
message(SUB_SRCS = ${SUB_SRCS})
# SUB_SRCS=./sub/dd.c