std::source_location

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

std::source_location 符合可默认构造 (DefaultConstructible) 、可复制构造 (CopyConstructible) 、可复制赋值 (CopyAssignable) 和可析构 (Destructible) 要求。std::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>

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

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

成员函数

示例

#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!

参阅