std::source_location
来自cppreference.com
| 定义于头文件 <source_location>
|
||
| struct source_location; |
(C++20 起) | |
source_location 类表示关于源码的具体信息，例如文件名、行号以及函数名。以前，希望获得关于调用位置的信息（用于记录、测试或调试目的）的函数必须使用宏，以令如 __LINE__ 与 __FILE__ 的预定义宏于调用方的环境展开。 source_location 类提供更好的替代。
source_location 符合可默认构造 (DefaultConstructible) 、可复制构造 (CopyConstructible) 、可复制赋值 (CopyAssignable) 及可析构 (Destructible) 要求。 source_location 的左值符合可交换 (Swappable) 要求。
另外，下列条件为 true ：
- std::is_nothrow_move_constructible_v<std::source_location> 、
- std::is_nothrow_move_assignable_v<std::source_location> 及
- std::is_nothrow_swappable_v<std::source_location> 。
有意令 source_location 拥有较小的大小并且能高效复制。
source_location 的复制/移动构造函数与复制/移动赋值运算符是否为平凡和/或 constexpr 是未指明的。
成员函数
创建 | |
构造拥有实现定义的值的新 source_location (公开成员函数) | |
| [静态] |
构造对应调用点位置的新 source_location (公开静态成员函数) |
域访问 | |
| 返回此对象所表示的行号 (公开成员函数) | |
| 返回此对象所表示的列号 (公开成员函数) | |
| 返回此对象所表示的文件名 (公开成员函数) | |
| 返回此对象表示的函数名，若它存在 (公开成员函数) | |
示例
运行此代码
#include <iostream> #include <string_view> #include <source_location> void log(std::string_view message, const std::source_location& location = std::source_location::current()) { std::cout << "info:" << location.file_name() << ':' << location.line() << ' ' << message << '\n'; } int main() { log("Hello world!"); }
可能的输出：
info:main.cpp:15 Hello world!
