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!
参阅
(C++23) |
栈踪中求值的表示 (类) |