std::source_location在C++20中用于自动捕获文件名、行号、函数名等源码信息,通过current()获取调用点位置,支持日志和断言中无需手动传入__FILE__、__LINE__,提升调试效率。

在C++20中,std::source_location 是一个轻量级的类,用于在编译时捕获源代码的上下文信息,比如文件名、行号、函数名等。它非常适合用在日志记录、断言、调试输出等场景,避免手动传入 __FILE__、__LINE__ 等宏。
基本特性与成员函数
std::source_location 提供了以下只读访问接口:
- file_name():返回当前源文件路径(const char*)
- line():返回当前行号(unsigned int)
- column():返回列号(通常实现为1或未完全支持)
- function_name():返回所在函数名(const char*),通常是经过修饰的名称(mangled)
这个类型是隐式构造的,通常通过 std::source_location::current() 获取当前位置信息,且该调用不会产生运行时开销(在优化后基本被常量替代)。
如何使用 source_location 记录日志
你可以将 std::source_location 作为默认参数传入日志函数,自动捕获调用点信息:
立即学习“C++免费学习笔记(深入)”;
#include#include #include void log(std::string_view message, std::source_location loc = std::source_location::current()) { std::cout << "[" << loc.file_name() << ":" << loc.line() << "] " << loc.function_name() << " - " << message << '\n'; }
void some_function() { log("Something happened!"); // 输出: [main.cpp:xx] some_function - Something happened! }
注意:由于 function_name() 返回的是编译器内部的函数签名(可能包含模板、重载信息并被 mangling 处理),实际显示可能不够友好。可结合工具如 c++filt 解析,或仅用于调试。
在断言中使用 source_location 提供更详细的错误信息
自定义断言宏可以利用 source_location 避免重复写文件和行号:
#include#include #include void assertion_failed(const std::source_location& loc) { std::cerr << "Assertion failed at " << loc.file_name() << ":" << loc.line() << " in " << loc.function_name() << "\n"; std::abort(); }
define MY_ASSERT(expr) \
do { \ if (!(expr)) { \ assertion_failed(std::source_location::current()); \ } \ } while(0)void test() { MY_ASSERT(2 + 2 == 5); // 输出: Assertion failed at test.cpp:xx in test }
这种方式比传统宏组合更简洁,也更容易维护。
注意事项与限制
- 编译器支持:需 C++20 支持,GCC 10+、Clang 10+、MSVC 19.29+ 基本可用
- 函数名可读性:
function_name()返回值可能很长且难读,不适合直接展示给终端用户- 不能跨线程保存:虽然
source_location是普通类型,但其内容依赖于调用点,若延迟使用仍反映原始位置- 默认参数限制:只能在函数调用时自动填充,无法在 lambda 或某些泛型上下文中直接捕获(除非显式传参)
基本上就这些。std::source_location 让日志和诊断信息变得更清晰、更自动化,是 C++20 中提升调试体验的小而美的特性。










