std::source_location

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

入出力ライブラリ

ローカライゼーションライブラリ

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

ファイルシステムライブラリ (C++17)

技術仕様書

 

ユーティリティライブラリ

型サポート (基本型、RTTI、型特性)
動的メモリ管理
エラー処理
プログラムユーティリティ
可変長引数関数
ライブラリ機能テストマクロ
日付と時間
関数オブジェクト
書式化ライブラリ (C++20)
initializer_list (C++11)
source_location (C++20)
bitset
hash (C++11)
integer_sequence (C++14)
関係演算子 (C++20で非推奨)
rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>=
比較 (C++20)
three_way_comparablethree_way_comparable_with
strong_ordering weak_ordering partial_ordering strong_equality weak_equality common_comparison_category compare_three_way_result	strong_order weak_order partial_order compare_strong_order_fallback compare_weak_order_fallback compare_partial_order_fallback compare_three_way	is_eqis_neqis_ltis_lteqis_gtis_gteq
一般的な語彙の型
pair tuple (C++11) apply (C++17) make_from_tuple (C++17)	optional (C++17) any (C++17) variant (C++17)
スワップ、転送、ムーブ
swap
exchange (C++14)
forward (C++11)
move (C++11)
move_if_noexcept (C++11)
初等文字列変換
to_chars (C++17)
from_chars (C++17)
chars_format (C++17)
型操作
declval (C++11)
as_const (C++17)
launder (C++17)

 

std::source_location

メンバ関数

作成

source_location::source_location

source_location::current

フィールドアクセス

source_location::line

source_location::column

source_location::file_name

source_location::function_name

 

ヘッダ <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 を構築します (パブリックメンバ関数)
current [静的]	呼び出し元の位置に対応する新しい source_location を構築します (パブリック静的メンバ関数)
フィールドアクセス
line	このオブジェクトが表す行番号を返します (パブリックメンバ関数)
column	このオブジェクトが表す桁番号を返します (パブリックメンバ関数)
file_name	このオブジェクトが表すファイル名を返します (パブリックメンバ関数)
function_name	このオブジェクトが表す関数名 (もしあれば) を返します (パブリックメンバ関数)

例

Run this code

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