C/C++获取文件名的方法
- 使用
__FILE__
宏可以获取当前源码文件的文件名
- 使用
__builtin_FILE()
函数__builtin_FILE()是一个内建函数,不同于__FILE__是一个预定义宏,因此__builtin_FILE()的效率可能更高。
- 使用
__BASE_FILE__
宏与__FILE__宏和__builtin_FILE()函数功能类似,它只包含当前编译单元的文件名,不包含任何路径信息(理论上是这样,实际往往跟__FILE__内容一致)。
- 使用
__PRETTY_FUNCTION__
宏__func__宏可以获取当前函数名,而__PRETTY_FUNCTION__宏可以获取当前函数的带有参数和返回类型的完整签名,其中包含了源码文件路径。
- 使用标准库中的
getenv
函数获取pwd
路径pwd 大家都懂。
- Windows API函数GetModuleFileName()
使用Windows API函数GetModuleFileName()可以获取当前程序的完整路径
- 编译时,譬如在cmake中获取文件名,并声明宏
编译时必然要获取所有源文件,这时候用这些文件名定义一个宏即可。
__FILE__宏
近年来,C/C++标准中的__FILE__宏定义引起了广泛关注。该宏定义可用于获取当前程序的文件路径,但是它也有一些限制和风险。
首先,让我们来看看__FILE__宏定义的定义和用法。__FILE__宏定义的作用是返回当前源文件的名称,这个名称可以在命令行或环境变量中设置。例如,假设你在C语言中编写了一个文件读取函数readFile,并且在代码中定义了myfile.c作为目标文件名,那么你可以使用以下代码获取当前文件的名称:
#include <stdio.h> int main() { printf("Current file name: %s\n", __FILE__); return 0; }
然而,由于该宏定义只能返回当前源文件的名称,因此在某些情况下可能会导致问题。例如,如果你正在使用共享库或第三方库,而这些库或库中使用了与原始文件不同的文件名,那么__FILE__宏定义就无法正确地获取到库或库中使用的文件名。此外,即使在单线程环境下,__FILE__宏定义也不是一个安全的选项,因为它允许攻击者获取到当前程序的完整文件名。
因此,虽然__FILE__宏定义非常有用,但我们需要考虑它的安全性和限制。在实际应用中,我们可以通过使用更加安全的文件操作函数来替换__FILE__宏定义。例如,在Windows系统中,你可以使用资源管理器来读取和写入文件,而不需要使用预处理器指令。在Linux系统中,你可以使用进程空间的文件访问权限来达到类似的效果。
接下来,让我们分析一下__FILE__宏定义存在的风险和限制。首先,__FILE__宏定义只能返回当前源文件的名称,因此在某些情况下可能会导致问题。例如,如果你正在使用共享库或第三方库,而这些库或库中使用了与原始文件不同的文件名,那么__FILE__宏定义就无法正确地获取到库或库中使用的文件名。此外,即使在单线程环境下,__FILE__宏定义也不是一个安全的选项,因为它允许攻击者获取到当前程序的完整文件名。
其次,__FILE__宏定义还有一些局限性,它并不能正确地返回当前程序的真正文件路径。事实上,计算机文件系统的逻辑结构是非常复杂的,它由多个层次组成。例如,根目录下的子目录结构、父目录结构等都会影响到文件的真正路径。因此,__FILE__宏定义并不能准确地反映出文件的路径。
- 避免__FILE__宏的错误
FILE 宏返回的是绝对路径的名称,但是在很多时候我们只需要获取文件名即可,而不需要那一长段繁琐的目录前缀,这时候我们需要对
__FILE__
宏重定义,当然这只是在不得不用__FILE__宏的情况,如果不是这样,你完全可以用其他方式。。避免__FILE__宏被重定向到错误的文件,我们可以按照以下建议进行操作:
如果使用的是CMake 3.14及以上版本,可以使用CMAKE_CURRENT_LIST_FILE
变量来获取当前正在处理的CMake列表文件的完整路径,而不是使用__FILE__宏。
- 如果您的项目中使用了多个CMake文件,可以在每个文件中使用不同的宏定义来避免重复定义__FILE__宏。,需要仔细检查您的代码和CMake文件,并确保它们是正确的,并使用适当的宏定义和变量来获取文件路径。
- 慎用
$(subst $(dir $<),,$<)\"'")
来重定义这个语法是GNU make中的函数subst的使用,用于将字符串中的某个子串替换为另一个字符串。
在 Makefile 中,$<
表示当前规则中的第一个依赖文件,$(dir $<)
表示$<
的目录部分,$(subst OLD,NEW,TEXT)
表示将 TEXT 中的 OLD 字符串替换为 NEW 字符串。
因此,(subst(subst(subst (dir < ) , , <),,<),,<) 表示将 $< 中的目录部分替换为空,即只保留文件名部分。
例如,如果当前规则中的第一个依赖文件是 src/foo/bar.c,那么$(dir $<)
的值为src/foo/,$(subst $(dir $<),,$<)
的值就是 bar.c。然后,“'”) 表示在文件名后添加一个双引号和单引号,以便将文件名传递给编译器。
在cmake工程中
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -U__FILE__ -D__FILE__='\"$(subst $(dir $<),,$<)\"'")
这个命令告诉编译器不要定义__FILE__宏,而是在后面使用-D__FILE__='“(subst(subst(subst (dir < ) , , <),,<),,<)”'选项重新定义__FILE__宏,将其重定向到输入文件的相对路径。依赖文件名并不一定意味着源文件名,有时候会被指定为编译器依赖项文件名。
这时候我们的__FILE__就会得不到正确的文件名,而且重定向到错误的中间文件名上,比如compiler_depend.ts
文件,有关此文件的介绍可以查看:Cmake 中 compiler_depend.ts文件
__BASE_FILE__宏
如果您使用的是GCC编译器,可以使用
__BASE_FILE__
宏来获取当前源文件的路径,而不是使用__FILE__宏。该宏在GCC 4.3及以上版本中可用。
__BASE_FILE__宏包含文件名,但不包含文件路径。但是,如果你在源代码中包含了文件路径,那么__BASE_FILE__宏的值将包含路径。这是由于__BASE_FILE__宏的值是在预处理阶段计算的,此时源代码中包含的文件路径已经被展开了。
例如,假设你的源代码文件位于/path/to/source目录下,且包含以下行:#include "file.h"
在预处理阶段,这行代码将被展开为:#include "/path/to/source/file.h"
因此,在这种情况下,__BASE_FILE__宏的值将是file.h,但包含路径/path/to/source`。
__builtin_FILE()函数
__builtin_FILE()函数确实是GCC内置函数之一,但是其具体实现并不是源代码形式的,而是由GCC编译器自带的。因此,我们无法提供其具体源代码的定义。__builtin_FILE()函数的实现方式可能随着GCC版本的更新而发生变化,因此无法确切地给出其源代码的定义。
__builtin_FILE()函数的作用是获取当前文件的文件名,它是由编译器自动实现的。在使用该函数时,只需要在代码中调用__builtin_FILE()函数即可,无需手动编写该函数的源代码。由于是内建函数,可以被编译器优化,理论上比__FILE__宏效率更高。
重定义时要指定参数set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fno-builtin")
Windows API函数GetModuleFileName()
GetModuleFileName()是Windows API函数之一,用于获取指定模块的文件名,包括路径和文件名。该函数提供了一种方法,可以在运行时获取当前可执行文件的路径和文件名。
DWORD GetModuleFileName( HMODULE hModule, LPSTR lpFilename, DWORD nSize );
其中,hModule参数指定要获取路径和文件名的模块的句柄。如果该参数为NULL,则GetModuleFileName()函数将返回调用它的可执行文件的路径和文件名。
lpFilename参数是指向一个缓冲区的指针,用于接收路径和文件名。该缓冲区必须足够大,以至于可以容纳完整的路径和文件名。如果函数成功执行,lpFilename将包含路径和文件名。
nSize参数指定缓冲区的大小,以字节为单位。如果lpFilename缓冲区的大小小于路径和文件名的长度,函数将无法成功执行,并返回0。
GetModuleFileName()函数返回值表示复制到缓冲区的字符数,不包括结尾的空字符。如果函数执行失败,返回值为0。
使用GetModuleFileName()函数,我们可以在运行时获取当前可执行文件的路径和文件名,并将其存储到缓冲区中。例如:
#include <windows.h> #include <stdio.h> int main() { char path[MAX_PATH]; GetModuleFileName(NULL, path, MAX_PATH); printf("The current file is: %s\n", path); return 0; }
getenv()
使用getenv函数即可,没必要使用system之类执行shell命令的函数。
getenv() 函数的返回值是一个指向环境变量值的字符串指针,可以将其用于后续的操作,例如打印、比较等等。而 system() 函数的返回值是执行命令的状态码,用于判断命令是否执行成功。
getenv() 函数在获取环境变量时不会对系统进行任何修改,只是返回变量的值。而 system() 函数会执行指定的系统命令,可能会对系统进行修改,例如创建、删除文件等等。
#include <iostream> #include <cstdlib> int main() { const char* filename = std::getenv("PWD"); //获取当前工作目录 std::cout << filename << std::endl; return 0; }
使用cmake中的变量重定义__FILE__宏的CMake示例
- 根目录遍历子目录情况一:如果源文件在多个目录下,比如src和lib
# 遍历 src 目录下的源文件 file(GLOB_RECURSE SRC_FILES_SRC "${CMAKE_CURRENT_SOURCE_DIR}/src/*.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/*.cxx" "${CMAKE_CURRENT_SOURCE_DIR}/src/*.cc" "${CMAKE_CURRENT_SOURCE_DIR}/src/*.c") # 遍历 lib 目录下的源文件 file(GLOB_RECURSE SRC_FILES_LIB "${CMAKE_CURRENT_SOURCE_DIR}/lib/*.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/lib/*.cxx" "${CMAKE_CURRENT_SOURCE_DIR}/lib/*.cc" "${CMAKE_CURRENT_SOURCE_DIR}/lib/*.c") # 合并源文件列表 set(SRC_FILES ${SRC_FILES_SRC} ${SRC_FILES_LIB}) # 添加源文件到项目中 foreach(SRC_FILE ${SRC_FILES}) # 获取相对路径和文件名 file(RELATIVE_PATH FILE_REL_PATH ${CMAKE_CURRENT_SOURCE_DIR} ${SRC_FILE}) string(REPLACE ${CMAKE_CURRENT_SOURCE_DIR}/ "" MY_FILE_NAME ${FILE_REL_PATH}) # 设置源文件的宏定义 set_source_files_properties(${SRC_FILE} PROPERTIES COMPILE_DEFINITIONS "__FILE__=\\\"${MY_FILE_NAME}\\\"") # 添加源文件到项目中 add_executable(my_project ${SRC_FILE}) endforeach()
- 根目录遍历子目录情况二:如果每个目录都有可执行文件要生成
file(GLOB_RECURSE SRC_FILES_SRC1"${CMAKE_CURRENT_SOURCE_DIR}/libs/*.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/libs/*.cxx" "${CMAKE_CURRENT_SOURCE_DIR}/libs/*.cc" "${CMAKE_CURRENT_SOURCE_DIR}/libs/*.c" "libs/subdir1/*.cpp" "libs/subdir1/*.cxx" "libs/subdir1/*.cc" "libs/subdir1/*.c" "libs/subdir2/*.cpp" "libs/subdir2/*.cxx" "libs/subdir2/*.cc" "libs/subdir2/*.c") foreach(SRC_FILE ${SRC_FILES_SRC1}) # 获取相对路径和文件名 file(RELATIVE_PATH FILE_REL_PATH ${CMAKE_CURRENT_SOURCE_DIR}/src1 ${SRC_FILE}) string(REPLACE "src1/" "" MY_FILE_NAME ${FILE_REL_PATH}) # 设置源文件的宏定义 set_source_files_properties(${SRC_FILE} PROPERTIES COMPILE_DEFINITIONS "__FILE__=\\\"${MY_FILE_NAME}\\\"") endforeach() add_executable(executable1) target_sources(executable1 PRIVATE ${SRC_FILES_SRC1})
- 最简单的方式:遍历源文件获取名称并重定义__FILE__宏
#遍历源码文件获取文件名逐以重定义宏 foreach(source ${USR_SOURCES}) get_filename_component(file_name ${source} NAME) set_source_files_properties(${source} PROPERTIES COMPILE_DEFINITIONS "FILE_NAME=\"${file_name}\";__FILE__=FILE_NAME") endforeach()