0

0

c++的std::source_location是什么 编译期获取代码位置信息【详解】

裘德小鎮的故事

裘德小鎮的故事

发布时间:2026-01-08 19:04:02

|

903人浏览过

|

来源于php中文网

原创

std::source_location是C++20引入的运行时源位置工具,提供file_name()、line()、column()、function_name()四个成员获取调用点文件名、行号、列号和函数名,默认参数方式自动注入,开销极小。

c++的std::source_location是什么 编译期获取代码位置信息【详解】

std::source_location 是 C++20 引入的标准库工具,用于在运行时获取调用点的源码位置信息(文件名、行号、函数名、列号),它不是编译期常量,但由编译器在调用处自动构造,开销极小,语义上“就近捕获”。

它能获取哪些信息

通过四个成员函数可访问关键位置数据:

  • file_name():返回 const char*,通常是完整路径(如 "/home/user/proj/main.cpp"),具体取决于编译器和构建配置
  • line()unsigned int,调用该函数的源码行号(不是 source_location 定义处,而是调用处)
  • column()unsigned int,大致列偏移(精度有限,部分编译器可能固定返回 1)
  • function_name()const char*,调用点所在函数的未修饰名(如 "main""process_data"),不保证是完整签名

典型用法:作为默认参数自动注入

最实用的方式是把它设为函数的默认参数,编译器会在每次调用时自动填入当前上下文的位置信息:

陌言AI
陌言AI

陌言AI是一个一站式AI创作平台,支持在线AI写作,AI对话,AI绘画等功能

下载
void log_error(const char* msg, 
               const std::source_location loc = std::source_location::current()) {
    std::cerr << "[" << loc.file_name() << ":" << loc.line() 
              << "] " << msg << "\n";
}

// 调用时无需传参,位置信息由编译器隐式提供 log_error("Failed to open config file"); // 输出类似:[main.cpp:42] Failed to open config file

注意:std::source_location::current() 是一个编译器内置机制,不是普通函数调用——它不执行运行时逻辑,也不受内联/优化影响,位置始终指向调用点。

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

关键限制与注意事项

  • 不是 constexpr:不能用于模板非类型参数或 static_assert 等需要编译期常量的场景
  • 不可手动构造有意义的实例:除 current() 外,其他构造函数(如带参数的)行为是未定义的或仅用于特殊调试用途,不应依赖
  • 路径格式不标准化file_name() 可能是绝对路径、相对路径,甚至只是文件名,取决于编译命令(如 -frecord-command-line 或构建系统设置)
  • 函数名可能被裁剪或修饰:尤其在启用链接时优化(LTO)或某些 ABI 下,function_name() 可能返回空串或简化名

适用场景举例

  • 轻量级日志:替代宏 __FILE__ / __LINE__,更类型安全、可重载、支持自定义格式
  • 断言增强:在自定义 assert 中携带上下文,比传统宏更容易集成进类或命名空间
  • 测试框架:自动标注失败用例的位置,减少手工写 TEST_CASE("xxx", "[file:line]")
  • 资源追踪:记录内存分配/句柄创建的源头,辅助调试泄漏(配合堆栈回溯效果更佳)

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

1463

2023.10.24

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

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

520

2023.09.20

string转int
string转int

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

315

2023.08.02

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

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

529

2024.08.29

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

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

50

2025.08.29

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

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

193

2025.08.29

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

382

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

567

2023.08.10

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

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

58

2026.01.09

热门下载

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

精品课程

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

共58课时 | 3.4万人学习

Pandas 教程
Pandas 教程

共15课时 | 0.9万人学习

ASP 教程
ASP 教程

共34课时 | 3.3万人学习

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

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