std:: source_location

std::source_location 类用于表示源代码的特定信息，例如文件名、行号和函数名。以往需要获取调用处这类信息（用于日志记录、测试或调试目的）的函数必须使用宏，以便像 __LINE__ 和 __FILE__ 这样的 预定义宏 在调用方上下文中展开。 std::source_location 类为此提供了更优的替代方案。

std::source_location 满足 DefaultConstructible 、 CopyConstructible 、 CopyAssignable 、 Destructible 以及 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 的复制/移动构造函数及复制/移动赋值运算符是否为平凡和/或常量表达式。

成员函数

注释

示例

#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 << "file: "
              << 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!");
}

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

参见