0

0

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

尼克

尼克

发布时间:2025-12-19 19:46:34

|

177人浏览过

|

来源于php中文网

原创

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++免费学习笔记(深入)”;

Evoker
Evoker

一站式AI创作平台

下载
#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 中提升调试体验的小而美的特性。

相关专题

更多
java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1465

2023.10.24

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

524

2023.09.20

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

317

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

538

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

52

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

197

2025.08.29

javascriptvoid(o)怎么解决
javascriptvoid(o)怎么解决

javascriptvoid(o)的解决办法:1、检查语法错误;2、确保正确的执行环境;3、检查其他代码的冲突;4、使用事件委托;5、使用其他绑定方式;6、检查外部资源等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

175

2023.11.23

java中void的含义
java中void的含义

本专题整合了Java中void的相关内容,阅读专题下面的文章了解更多详细内容。

97

2025.11.27

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

27

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 6.9万人学习

C 教程
C 教程

共75课时 | 4.1万人学习

C++教程
C++教程

共115课时 | 12.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号