std::source_location

来自cppreference.com
< cpp‎ | utility
 
C++
 
工具库
通用工具
关系运算符 (C++20 弃用)
 
std::source_location
 
在标头 <source_location> 定义
struct source_location;
 (C++20 起)

std::source_location 类表示关于源代码的特定信息，如文件名、行号以及函数名。以前，希望获得关于调用位置的信息（用于记录、测试或调试目的）的函数必须使用宏，如 __LINE__ 和 __FILE__ 的等预定义宏在调用方的环境中展开。std::source_location 类提供了更好的替代品。

std::source_location 满足可默认构造 (DefaultConstructible) 、可复制构造 (CopyConstructible) 、可复制赋值 (CopyAssignable) 、可析构 (Destructible) 和可交换 (Swappable) 。

另外，下列条件都是 true：

有意使 std::source_location 具有较小的大小并且能高效复制。

未指定 std::source_location 的复制/移动构造函数与复制/移动赋值运算符是否为平凡和/或 constexpr。

目录

[编辑] 成员函数

创建
构造拥有实现定义的值的新 source_location
(公开成员函数) [编辑]
[静态]
 构造对应调用点位置的新 source_location
(公开静态成员函数) [编辑]
域访问
返回此对象表示的行号
(公开成员函数) [编辑]
返回此对象表示的列号
(公开成员函数) [编辑]
返回此对象表示的文件名
(公开成员函数) [编辑]
返回此对象表示的函数名，如果存在
(公开成员函数) [编辑]

[编辑] 注解

功能特性测试宏 值 标准 功能特性
__cpp_lib_source_location 201907L (C++20) 源代码信息捕获 (std::source_location)

[编辑] 示例

运行此代码
#include <iostream>
#include <source_location>
#include <string_view>
 
void log(const std::string_view message,
         const std::source_location location =
               std::source_location::current())
{
    std::clog << "文件: "
              << location.file_name() << '('
              << location.line() << ':'
              << location.column() << ") `"
              << location.function_name() << "`: "
              << message << '\n';
}
 
template<typename T>
void fun(T x)
{
    log(x); // 第 20 行
}
 
int main(int, char*[])
{
    log("Hello world!"); // 第 25 行
    fun("Hello C++20!");
}

可能的输出： 

文件: main.cpp(25:8) `int main(int, char**)`: Hello world!
文件: main.cpp(20:8) `void fun(T) [with T = const char*]`: Hello C++20!

[编辑] 参阅

 更改源代码的行号，也可以同时更改当前文件名
(预处理指令) [编辑]
(C++23)
 表示栈踪迹中求值的项
(类) [编辑]
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/utility/source_location&oldid=96557”