
从 C++20 开始,std::source_location 成为标准库的一部分,它提供了一种轻量、高效的方式来获取代码中调用点的位置信息,比如文件名、行号、函数名等。这个功能特别适合用于日志记录、调试输出和断言处理。
包含头文件并启用 C++20
要使用 std::source_location,首先确保你的编译器支持 C++20,并在代码中包含头文件:
#include#include iostream>
编译时需要启用 C++20 标准,例如使用 g++:
g++ -std=c++20 your_file.cpp -o your_program获取当前位置信息
std::source_location 提供了静态方法 current(),它会在调用点自动捕获源码位置。常用成员函数包括:
立即学习“C++免费学习笔记(深入)”;
- file_name():返回文件名(含路径)
- line():返回行号
- column():返回列号(部分编译器可能不精确)
- function_name():返回函数名(通常是修饰后的名称)
示例代码:
void log_info(const std::source_location& loc = std::source_location::current()) {std::cout std::cout std::cout }
void test_function() {
log_info(); // 自动捕获调用位置
}
输出类似:
文件: main.cpp行号: 10
函数: void test_function()
在日志宏中使用 source_location
结合宏定义,可以更方便地在多处插入带位置信息的日志:
#define LOG() log_info(std::source_location::current())这样每次调用 LOG() 都会打印当前的文件、行号和函数名。
注意:std::source_location::current() 是隐式生成的,只在默认参数中能正确捕获调用位置。如果手动传参,需确保传的是 std::source_location::current() 而非预先保存的实例。
注意事项与限制
不同编译器对 function_name() 的输出格式可能不同,通常包含返回类型和参数,是经过修饰的符号名。某些场景下可能需要解析或美化输出。
列号(column)的支持有限,GCC 和 Clang 可能返回 0 或近似值,实际使用中建议以行号为主。
基本上就这些。std::source_location 不复杂但容易忽略细节,关键是放在默认参数里自动捕获位置。调试和日志中非常实用。











