0

0

C++中的std::source_location有什么用?(获取代码文件名和行号)

冰火之心

冰火之心

发布时间:2026-01-09 11:54:09

|

824人浏览过

|

来源于php中文网

原创

c++kquote>std::source_location 是 C++20 引入的轻量值类型,不能直接替代 FILE 和 LINE 宏,因其 current() 是函数调用、反映调用点而非定义点;正确用法是作为带默认值的函数参数(按值传递),由编译器在每次调用时自动注入实际位置信息。

c++中的std::source_location有什么用?(获取代码文件名和行号)

std::source_location 是什么,能直接替代 __FILE__ 和 __LINE__ 吗?

std::source_location 是 C++20 引入的标准设施,用于在编译期捕获调用点的源码位置信息。它不是宏,而是一个轻量值类型,包含 file_name()line()column()function_name() 四个只读访问函数。它不能直接替代 __FILE____LINE__ 的宏展开行为——因为 std::source_location::current() 是一个函数调用,其返回值反映的是该函数被调用处的位置,而非宏定义处。

常见误用是把它写成全局变量或静态常量初始化:

static const auto loc = std::source_location::current(); // ❌ 错!总指向这行

正确做法是让它作为函数参数默认值,在每次调用时自动注入实际调用点信息。

怎么让日志函数自动记录调用位置?

最典型用途是为日志、断言、调试工具注入上下文。关键在于把 std::source_location 设为带默认值的函数参数:

立即学习C++免费学习笔记(深入)”;

  • 默认值必须是 std::source_location::current(),不能加括号以外的任何表达式(如 std::source_location{} 会固定为定义处)
  • 参数必须按值传递(它是 trivially copyable,无开销)
  • 不能是模板参数推导目标(它不参与重载/推导)

示例:

void log(const char* msg, std::source_location loc = std::source_location::current()) {
    fprintf(stderr, "[%s:%d] %s\n", loc.file_name(), loc.line(), msg);
}
// 调用方完全无感知:
log("buffer overflow"); // 自动捕获这一行的文件和行号

为什么 function_name() 返回的不是完整签名,且内容不可移植?

function_name() 返回的是编译器生成的符号名(mangled name),标准只要求它“尽可能描述调用点所在函数”,不保证可读性或跨编译器一致。GCC 可能返回 "void foo()",Clang 可能返回 "foo",MSVC 可能返回

雪鸮AI
雪鸮AI

高效便捷的智能绘图辅助工具,一键生成高质量效果图。

下载

如果你需要稳定可读的函数名:

  • 不要依赖 function_name() 做逻辑判断(比如 switch 或 if 比较)
  • 调试输出可以保留,但日志归类、监控告警等生产场景应避免用它做 key
  • 真正需要符号名解析时,应结合外部工具(如 addr2line、llvm-symbolizer)或 ABI 解析库

和 assert / static_assert 有什么关系?

std::source_locationassert 没有直接集成,C++23 才引入 std::assertion_handler 支持自定义断言处理,但目前主流标准库(libstdc++、libc++、MSVC STL)的 assert 仍基于传统宏,输出由预处理器决定。

你可以自己封装断言宏来桥接:

#define MY_ASSERT(x) do { \
    if (!(x)) { \
        log_assert(#x, std::source_location::current()); \
        std::abort(); \
    } \
} while(0)

void log_assert(const char* expr, std::source_location loc) { fprintf(stderr, "Assertion failed: %s at %s:%d\n", expr, loc.file_name(), loc.line()); }

注意:宏里调用 std::source_location::current() 是安全的,因为宏展开后它出现在调用点,不是宏定义内部。

真正容易被忽略的是:std::source_location 在 constexpr 函数中无法使用 current()(编译期无法确定“调用点”),所以它只适用于运行时上下文;另外,某些嵌入式或 freestanding 环境可能未实现该特性,需检查 __cpp_lib_source_location 宏。

相关专题

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

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

1463

2023.10.24

全局变量怎么定义
全局变量怎么定义

本专题整合了全局变量相关内容,阅读专题下面的文章了解更多详细内容。

73

2025.09.18

python 全局变量
python 全局变量

本专题整合了python中全局变量定义相关教程,阅读专题下面的文章了解更多详细内容。

96

2025.09.18

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

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

174

2023.11.23

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

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

95

2025.11.27

java值传递和引用传递有什么区别
java值传递和引用传递有什么区别

java值传递和引用传递的区别:1、基本数据类型的传递;2、对象的传递;3、修改引用指向的情况。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

106

2024.02.23

Golang 分布式缓存与高可用架构
Golang 分布式缓存与高可用架构

本专题系统讲解 Golang 在分布式缓存与高可用系统中的应用,涵盖缓存设计原理、Redis/Etcd集成、数据一致性与过期策略、分布式锁、缓存穿透/雪崩/击穿解决方案,以及高可用架构设计。通过实战案例,帮助开发者掌握 如何使用 Go 构建稳定、高性能的分布式缓存系统,提升大型系统的响应速度与可靠性。

60

2026.01.09

java学习网站推荐汇总
java学习网站推荐汇总

本专题整合了java学习网站相关内容,阅读专题下面的文章了解更多详细内容。

61

2026.01.08

java学习网站汇总
java学习网站汇总

本专题整合了java学习网站相关内容,阅读专题下面的文章了解更多详细内容。

0

2026.01.08

热门下载

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

精品课程

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

共58课时 | 3.5万人学习

Pandas 教程
Pandas 教程

共15课时 | 0.9万人学习

ASP 教程
ASP 教程

共34课时 | 3.4万人学习

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

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