std::source_location

struct 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 的复制/移动构造函数以及复制/移动赋值运算符是否为平凡的和/或 constexpr。

成员函数

注释

示例

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

参阅