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); // line 20
}
int main(int, char*[])
{
    log("Hello world!"); // line 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!

関連項目