C++-Cmake指令：file【文件操作命令】【比如：file GLOB命令主要用于匹配规则在指定的目录内匹配到所需要的文件】

使用cmake 文件操作时不可避免需要操作相关文件，比如读取文件内容，创建新文件的等等操作，都需要通过file命令进行操作。

一、读文件操作

1、file READ命令

常用的从文件中读取操作为file(READ <filename> <variable>)，将filename文件中内容原封不动读取到variable变量中，命令行全部格式为：

file(read <filename> <variable> [OFFSET <offset>] [LIMIT <max-in>] [HEX])

• filename: 必选项 为要读取的文件，可以带绝对路径
• variable: 必选项，将文件内容读取到varible变量中。
• OFFSET <offset>：可选项，从文件中偏移位置offset 开始读取文件内容
• HEX：可选项，可以将读取文件内容转换成十六进制。

LIMIT <max-in>: 可选项 最多读取<max-in>长度的内容到变量中

以一个例子说明，实验目录下有两个文件,使用tree命令查看：

$ tree
.
├── CMakeLists.txt
└── test.cpp

0 directories, 2 files
$

test.cpp文件内容如下：

#include <stdio.h>
#include <stdlib.h>
 
 
 
int main(){
    printf("hello world!\n");
}

CMakeList.txt文件内容如下：

cmake_minimum_required(VERSION 3.13.4)
 
project(cmake_read)
 
message("--------Proj Src Dir: " ${PROJECT_SOURCE_DIR})
file(READ ${PROJECT_SOURCE_DIR}/test.cpp TEST_RESULT)
message("--------TEST RESULT: " ${TEST_RESULT})

使用file(read)命令将文件test.cpp的内容读取到TEST_RESULT变量中，并打印出来，使用cmake运行：

$  /public/home/huozhikun/cmake/cmake-3.17.0/bin/cmake ..
CMake Error: The source directory "/public/home/huozhikun/test/cmake/read" does not appear to contain CMakeLists.txt.
Specify --help for usage, or press the help button on the CMake GUI.
[huozhikun@login09 example]$ cd build/
[huozhikun@login09 build]$  /public/home/huozhikun/cmake/cmake-3.17.0/bin/cmake ..
-- The C compiler identification is GNU 7.3.1
-- The CXX compiler identification is GNU 7.3.1
-- Check for working C compiler: /opt/rh/devtoolset-7/root/usr/bin/cc
-- Check for working C compiler: /opt/rh/devtoolset-7/root/usr/bin/cc - works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Check for working CXX compiler: /opt/rh/devtoolset-7/root/usr/bin/c++
-- Check for working CXX compiler: /opt/rh/devtoolset-7/root/usr/bin/c++ - works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
--------Proj Src Dir: /public/home/huozhikun/test/cmake/read/example
--------TEST RESULT: #include <stdio.h>
#include <stdlib.h>
 
 
 
int main(){
    printf("hello world!\n")
}
 
-- Configuring done
-- Generating done
-- Build files have been written to: /public/home/huozhikun/test/cmake/read/example/build

将test.cpp的文件内容原封不动读取到TEST_RESULT变量中。

2、file STRINGS命令

file STRINGS命令是将文件的内容读取成一串ASCII字符串到变量中，其中二进制文件将会被忽略，在读取文件中 回车及\r将会被忽略:

file(STRINGS <filename> <variable> [<options> ...])

3、file <HASH>

4、file TIMESTAMP

二、写文件操作

1、file WRITE命令

2、file APPEND命令

3、file TOUCH命令

4、file GENERATE命令

三、Filesystem

1、file GLOB命令

file GLOB命令主要用于匹配规则在指定的目录内匹配到所需要的文件，命令行格式：

file(GLOB <variable> [LIST_DIRECTORIES true[false]] [RELATIVE <path> ] [CONFIGURE_DEPENDS] [<globbing-expression> ...])

• LIST_DIRECTORIES true[false]: 如果为false，目录将会被省略，默认情况下返回是带目录
• RELATIVE <path>: 相对路径<path> 返回的结果将不是绝对路径，而是将绝对路径中的<path>部分去掉，返回相对路径
• CONFIGURE_DEPENDS:如果该标记位设置，在主构建系统检查目标添加逻辑，必便在构建时重新运行标记的GLOB命令
• <globbing-expression>：匹配表达式,表达式类似与正则匹配，如下：

*.cxx      - match all files with extension cxx
*.vt?      - match all files with extension vta,...,vtz
f[3-5].txt - match files f3.txt, f4.txt, f5.txt

用例

cmake_minimum_required(VERSION 3.13.4)
 
project(cmake_filesystem)
 
message("--------Proj Src Dir: " ${CMAKE_CURRENT_SOURCE_DIR})
 
file(GLOB TEST_RESULT LIST_DIRECT true RELATIVE /public/home *.cpp)
message("--------TEST_RESULT:  ${TEST_RESULT}")

寻找当前路径下的cpp文件，且返回的结果中为/public/home的相对路径，结果：

$  /public/home/huozhikun/cmake/cmake-3.17.0/bin/cmake ..
... ...
--------Proj Src Dir: /public/home/huozhikun/test/cmake/filesystem/example_3
--------TEST_RESULT:  huozhikun/test/cmake/filesystem/example_3/test_2.cpp
... ...

2、 file GLOB_RECURSE命令

3、file RENAME命令

4、RENAME_RECURES 

5、file MAKE_DIRECTORY命令

6、file COPY命令

file COPY命令用于将文件copy到目标目录中，命令行格式如下：

file(COPY <files> ... DESTINATION <dir>

         [FILE_PERMISSIONS <permissions> ...] 

         [DIRECTORY_PERMISSIONS <permissions> ... ]

         [NO_SOURCE_PERMISSIONS] [USE_SOURCE_PERMISSIONS]

         [FILES_MATCHING]

         [ [PATTERN <pattern> | REGEX <regex>]

           [EXCLUDE] [PERMISSIONS <permissions> ... ] ]

         [...])

• <files>：要拷贝的源文件
• DESTINATION <dir>：要将源文件拷贝到目的目录<dir>中
• FILE_PERMISSIONS <permissions>：修改源文件权限
• DIRECTORY_PERMISSIONS <permissions>：目录权限
• NO_SOURCE_PERMISSIONS：不使用源文件权限，对文件权限重新指定
• USE_SOURCE_PERMISSIONS：使用源文件权限，当该选项设置时，不能再使用FILE_PERMISSIONS权限，支持的权限设置有：

  • OWNER_READ

  • OWNER_WRITE

  • OWNER_EXECUTE

  • GROUP_READ

  • GROUP_WRITE

  • GROUP_EXECUTE

  • WORLD_READ

  • WORLD_WRITE

  • WORLD_EXECUTE

• PATTERN 和REGEX：制定一些匹配规则
• EXCLUDE: 不包括或排除调一些特殊文件

7、file INSTALL命令

四、路径转换（path conversion)

1、file  RELATIVE_PATH

2、file TO_CMAKE_PATH

3、 file TO_NATIVE_PATH

五、传送相关命令（transfer)

六、锁

CMake file文件操作命令_Huo的藏经阁的博客-CSDN博客_cmake file