std::source_location 可获取文件名、行号、列号和函数名。通过默认参数自动捕获调用位置,常用于日志、断言等场景,信息在编译期确定,性能开销极小,取代传统宏实现,代码更安全简洁。

source_location 是 C++20 引入的一个实用工具,定义在 头文件中。它允许程序在运行时或编译期获取当前代码的源码位置信息,比如文件名、行号、函数名等。这个功能特别适用于日志记录、调试断言、错误追踪等场景。
source_location 能获取哪些信息?
通过 std::source_location,你可以获取以下信息:
- 文件名(file_name)
- 行号(line)
- 列号(column)——某些编译器可能不支持精确列号
- 函数名(function_name)
这些信息是静态获取的,也就是说,在调用点自动填充,无需手动传参。
如何使用 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() << "\n" << "行号: " << loc.line() << "\n" << "函数: " << loc.function_name() << "\n" << "消息: " << message << "\n\n"; } void some_function() { log("发生了一个日志事件"); }
输出类似:
行号: 14
函数: some_function
消息: 发生了一个日志事件
在断言和错误处理中的应用
你可以用 source_location 增强自定义断言,让错误信息更清晰:
#define ASSERT(expr) \
do { \
if (!(expr)) { \
std::cerr << "断言失败: " #expr "\n" \
<< "文件: " << std::source_location::current().file_name() << "\n" \
<< "行号: " << std::source_location::current().line() << "\n" \
<< "函数: " << std::source_location::current().function_name() << "\n"; \
std::terminate(); \
} \
} while(0)
这样当断言触发时,能立刻定位到出错位置,极大提升调试效率。
编译期还是运行时?
std::source_location::current() 是一个特殊的函数,虽然看起来像普通函数调用,但它返回的是编译期常量。这意味着位置信息是在编译时确定的,性能开销极小,几乎可以忽略。
注意:尽管信息是编译期生成,但对象本身通常在运行时构造,不过现代编译器会高度优化这类操作。
基本上就这些。C++20 的 source_location 提供了一种类型安全、零成本的方式来获取源码位置,取代了过去依赖宏如 __FILE__ 和 __LINE__ 的方式,写法更简洁,语义更清晰。










