讲师中心 微信公众号
AI工具推荐 视频效率加速

C++如何使用std::source_location在日志中注入调用者函数名

星婷大大_7276

星婷大大_7276

发布时间:2026-06-28 13:45:23

|

830人浏览过

|

来源于php中文网

原创

std::source_location是C++20引入的编译期源位置设施,用于可靠获取调用点的文件、行号、列号和函数名;它通过默认参数机制自动注入调用者信息,优于__FUNCTION__等宏,但受编译器优化和内联影响可能返回空或"???"。

c++如何使用std::source_location在日志中注入调用者函数名

std::source_location 是什么,为什么不能直接用 __FUNCTION__

std::source_location 是 C++20 引入的标准设施,用于在编译期捕获调用点的文件、行号、列号和函数名。它比宏 __FUNCTION__ 或 __func__ 更可靠:后者只是字符串字面量,不参与类型系统,且在内联/模板展开后可能指向被调用函数而非实际调用者;而 std::source_location::function_name() 在绝大多数编译器(GCC 12+、Clang 13+、MSVC 19.30+)中能正确回溯到**直接调用点**的函数名——前提是别被优化掉或误传。

如何让日志宏自动注入调用者函数名

关键不是手动传参,而是利用 std::source_location::current() 的隐式默认参数特性。它必须作为函数最后一个参数(且有默认值),否则编译器不会自动填充:

void log_info(const char* msg, const std::source_location& loc = std::source_location::current()) {
    printf("[%s:%d %s] %s\n", 
           loc.file_name(), loc.line(), 
           loc.function_name(), // 这里拿到的是调用 log_info 的函数名
           msg);
}
  • 调用 log_info("hello") 时,loc 自动填入上层函数的源位置
  • 不能写成 log_info("hello", std::source_location::current()) —— 这会把 log_info 自己当作调用者
  • 不能把 std::source_location 放在参数列表中间或开头,否则默认参数失效

在模板日志函数里怎么用才不出错

模板函数同样支持默认 std::source_location 参数,但要注意实例化行为:

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载
template<typename... Args>
void log_fmt(const char* fmt, Args&&... args, 
             const std::source_location& loc = std::source_location::current()) {
    fprintf(stderr, "[%s:%d %s] ", loc.file_name(), loc.line(), loc.function_name());
    vfprintf(stderr, fmt, std::make_format_args(args...));
    fputc('\n', stderr);
}
  • 每个模板实例(如 log_fmt<int>("x={}", 42)</int>)都会生成一个带独立 loc 默认值的函数,没问题
  • 如果模板参数包 Args... 在 std::source_location 之前,会导致编译失败:C++ 不允许非尾部默认参数
  • MSVC 对 std::make_format_args 支持较晚(19.33+),若用旧版,改用 printf + std::vsnprintf 更稳妥

为什么有时 function_name() 返回空字符串或 "??"

这是常见陷阱,根源在编译器实现和优化策略:

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

  • GCC 在 -O2 及以上可能将 function_name() 优化为空串,加 -g 或 -frecord-gcc-switches 可缓解,但不保证
  • Clang 默认行为更稳定,但启用 -flto 后跨 TU 调用可能丢失函数名
  • 所有编译器对内联函数(inline、constexpr、模板实例)的 function_name() 都可能返回调用者而非定义者——这其实是符合标准的,因为 std::source_location::current() 捕获的是“调用该表达式的位置”,不是“该函数定义的位置”
  • 如果你发现总是返回 "???",检查是否忘了链接 -lstdc++(GCC)或启用了 /Zi(MSVC)

真正可靠的函数名来源仍是 __func__ 宏——但它只能在函数体内用,没法塞进通用日志函数。所以实际工程中,常把两者结合:优先用 std::source_location::function_name(),fallback 到 __func__(通过宏包裹),并接受它在某些构建配置下不可用的事实。

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2248

2024.03.14

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

1019

2024.03.14

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

447

2024.03.14

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

327

2024.03.14

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

406

2024.03.14

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

580

2024.03.14

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

1409

2024.03.21

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

1217

2024.03.22

Playwright 测试失败怎么办
Playwright 测试失败怎么办

Playwright测试失败专题汇集超时、定位器匹配、浏览器提前关闭、依赖与插件配置、文件上传、SSL及Docker启动等故障文章,并介绍通过截图、报告和Trace定位错误。

0

2026.10.21

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn