std::stacktrace_entry:: source_file

std:: string source_file ( ) const ;		(C++23以降)

* this によって表される評価対象の式または文が字句的に含まれるソースファイルの推定または実際の名前を返します。アロケーション失敗以外の失敗時（例： * this が空の場合）には空文字列を返します。

source_file が推定されるソースファイル名を返し、 source_line が推定される行番号を返すか、あるいは source_file が実際のソースファイル名を返し、 source_line が実際の行番号を返します。

目次 1 Parameters 2 Return value 3 Exceptions 4 Notes 5 Example 6 See also

パラメータ

(なし)

戻り値

成功時は上記で指定されたソースファイルの名前、アロケーション失敗以外の失敗時は空文字列。

例外

内部データ構造または結果の文字列のメモリを確保できない場合、 std::bad_alloc をスローします。

注記

ソースファイルの想定される名前は、定義済みマクロ __FILE__ が展開するものであり、 #line ディレクティブによって変更することができます。

この節は不完全です 理由: 「actual name」の定義が欠落しています ( LWG issue 3507 )

この関数に対するカスタムアロケータのサポートは提供されていません。なぜなら、実装には通常プラットフォーム固有の割り当て、システムコール、および大量のCPU集中型作業が必要であり、カスタムアロケータはプラットフォーム固有の操作が割り当てよりも桁違いに多くの時間を要するため、この関数に対してメリットを提供しないからです。

例

このセクションは不完全です 理由: 例がありません

関連項目

file_name

このオブジェクトが表すファイル名を返す ( std::source_location の公開メンバ関数)