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 可能返回

EasySub – AI字幕生成翻译工具
EasySub – AI字幕生成翻译工具

EasySub 是一款在线 AI 字幕生成器。 它提供AI语音识别、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中文网学习。

1465

2023.10.24

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

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

78

2025.09.18

python 全局变量
python 全局变量

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

96

2025.09.18

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

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

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

107

2024.02.23

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

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

42

2026.01.16

全民K歌得高分教程大全
全民K歌得高分教程大全

本专题整合了全民K歌得高分技巧汇总,阅读专题下面的文章了解更多详细内容。

74

2026.01.16

C++ 单元测试与代码质量保障
C++ 单元测试与代码质量保障

本专题系统讲解 C++ 在单元测试与代码质量保障方面的实战方法,包括测试驱动开发理念、Google Test/Google Mock 的使用、测试用例设计、边界条件验证、持续集成中的自动化测试流程,以及常见代码质量问题的发现与修复。通过工程化示例,帮助开发者建立 可测试、可维护、高质量的 C++ 项目体系。

23

2026.01.16

热门下载

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

精品课程

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

共58课时 | 3.8万人学习

Pandas 教程
Pandas 教程

共15课时 | 0.9万人学习

ASP 教程
ASP 教程

共34课时 | 3.7万人学习

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

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