C/C++ 获取文件名的方法:分享一些实用的获取文件名的方法和技巧(__FILE__,__builtin_FILE(),__BASE_FILE__等)

简介: C/C++ 获取文件名的方法:分享一些实用的获取文件名的方法和技巧(__FILE__,__builtin_FILE(),__BASE_FILE__等)

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()


目录
相关文章
|
7月前
|
存储 Java C++
C++ 引用和指针:内存地址、创建方法及应用解析
C++中的引用是现有变量的别名,创建时需用`&`运算符,如`string &meal = food;`。指针存储变量的内存地址,使用`*`创建,如`string* ptr = &food;`。引用必须初始化且不可为空,而指针可初始化为空。引用在函数参数传递和提高效率时有用,指针适用于动态内存分配和复杂数据结构操作。选择使用取决于具体需求。
106 9
|
6月前
|
算法 Linux C++
C++框架设计中实现可扩展性的方法
在软件开发中,可扩展性至关重要,尤其对于C++这样的静态类型语言。本文探讨了在C++框架设计中实现可扩展性的方法:1) 模块化设计降低耦合;2) 使用继承和接口实现功能扩展;3) 通过插件机制动态添加功能;4) 利用模板和泛型提升代码复用;5) 遵循设计原则和最佳实践;6) 应用配置和策略模式以改变运行时行为;7) 使用工厂和抽象工厂模式创建可扩展的对象;8) 实现依赖注入增强灵活性。这些策略有助于构建适应变化、易于维护的C++框架。
502 2
|
3月前
|
编译器 API C语言
超级好用的C++实用库之跨平台实用方法
超级好用的C++实用库之跨平台实用方法
45 6
|
3月前
|
JavaScript 前端开发 Java
通过Gtest访问C++静态、私有、保护变量和方法
通过Gtest访问C++静态、私有、保护变量和方法
96 0
|
4月前
|
C++
C++ 避免多重定义的方法
C++ 避免多重定义的方法
65 0
|
4月前
|
Dart API C语言
Dart ffi 使用问题之想在C/C++中创建异步线程来调用Dart方法,如何操作
Dart ffi 使用问题之想在C/C++中创建异步线程来调用Dart方法,如何操作
|
6月前
|
C++ 存储 Java
C++ 引用和指针:内存地址、创建方法及应用解析
'markdown'C++ 中的引用是现有变量的别名,用 `&` 创建。例如:`string &meal = food;`。指针通过 `&` 获取变量内存地址,用 `*` 创建。指针变量存储地址,如 `string *ptr = &food;`。引用不可为空且不可变,指针可为空且可变,适用于动态内存和复杂数据结构。两者在函数参数传递和效率提升方面各有优势。 ```
|
6月前
|
IDE 开发工具 C++
插件:CLion中使用C/C++ Single File Execution插件编译和运行单个文件
插件:CLion中使用C/C++ Single File Execution插件编译和运行单个文件
572 0
|
6月前
|
存储 编译器 程序员
C++语言速成方法
C++语言速成方法
|
6月前
|
C++ UED 开发者
逆向学习 MFC 篇:视图分割和在 C++ 的 Windows 窗口程序中添加图标的方法
逆向学习 MFC 篇:视图分割和在 C++ 的 Windows 窗口程序中添加图标的方法
91 0