C++的std::source_location如何使用_C++20中用于日志和断言的源码信息捕获-C++-PHP中文网

C++的std::source_location如何使用_C++20中用于日志和断言的源码信息捕获

尼克

发布： 2025-12-19 19:46:34

原创

177人浏览过

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

c++的std::source_location如何使用_c++20中用于日志和断言的源码信息捕获

在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++免费学习笔记（深入）”；

FaceSwapper

FaceSwapper是一款AI在线换脸工具，可以让用户在照片和视频中无缝交换面孔。

960

查看详情

#include <iostream>
#include <string_view>
#include <source_location>
<p>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';
}</p><p>void some_function() {
log("Something happened!"); 
// 输出: [main.cpp:xx] some_function - Something happened!
}</p>

登录后复制

注意：由于 function_name() 返回的是编译器内部的函数签名（可能包含模板、重载信息并被 mangling 处理），实际显示可能不够友好。可结合工具如 c++filt 解析，或仅用于调试。

在断言中使用 source_location 提供更详细的错误信息

自定义断言宏可以利用 source_location 避免重复写文件和行号：

#include <iostream>
#include <source_location>
#include <cassert>
<p>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();
}</p><h1>define MY_ASSERT(expr) \</h1><pre class='brush:php;toolbar:false;'>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 }

这种方式比传统宏组合更简洁，也更容易维护。