std::source_location

来自cppreference.com
< cpp‎ | utility
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
初等字符串转换
(C++17)
(C++17)
 
 
在标头 <source_location> 定义
struct source_location;
(C++20 起)

std::source_location 类表示关于源码的具体信息,例如文件名、行号以及函数名。以前,希望获得关于调用位置的信息(用于记录、测试或调试目的)的函数必须使用宏,以令如 __LINE____FILE__预定义宏在调用方的环境展开。std::source_location 类提供了更好的替代。

std::source_location 符合可默认构造 (DefaultConstructible) 可复制构造 (CopyConstructible) 可复制赋值 (CopyAssignable) 可析构 (Destructible) 要求。std::source_location 的左值符合可交换 (Swappable) 要求。

另外,下列条件都是 true

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

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

成员函数

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

示例

#include <iostream>
#include <source_location>
#include <string_view>
 
void log(std::string_view message,
         const std::source_location& location = std::source_location::current())
{
    std::cout << "信息:"
              << location.file_name() << ':'
              << location.line() << ' '
              << message << '\n';
}
 
int main()
{
    log("Hello world!");
}

可能的输出:

信息:main.cpp:16 Hello world!

参阅

更改源代码的行号,也可以同时更改当前文件名
(预处理指令)
栈踪中求值的表示
(类)