std::basic_format_args

 

C++

コンパイラサポート

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

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

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

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

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

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

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

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

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

フォーマットライブラリ (C++20)

ヌル終端シーケンスユーティリティ

バイト文字列

マルチバイト文字列

ワイド文字列

プリミティブな数値変換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

テキストエンコーディング識別

text_encoding (C++26)

 

書式設定ライブラリ

標準フォーマット指定

フォーマット関数

format (C++20)

format_to (C++20)

format_to_n (C++20)

formatted_size (C++20)

vformat (C++20)

vformat_to (C++20)

フォーマット文字列

basic_format_stringformat_stringwformat_string (C++20)(C++20)(C++20)

runtime_format (C++26)

フォーマット関連コンセプト

formattable (C++23)

フォーマッタ

formatter (C++20)

formatter<pair-or-tuple> (C++23)

formatter<range> (C++23)

range_formatter (C++23)

enable_nonlocking_formatter_optimization (C++23)

basic_format_parse_contextformat_parse_contextwformat_parse_context (C++20)(C++20)(C++20)

basic_format_contextformat_contextwformat_context (C++20)(C++20)(C++20)

range_format (C++23)

format_kind (C++23)

フォーマット引数

basic_format_arg (C++20)

basic_format_arg::handle (C++20)

basic_format_argsformat_argswformat_args (C++20)(C++20)(C++20)

visit_format_arg (C++20) (C++26で非推奨)

make_format_argsmake_wformat_args (C++20)(C++20)

フォーマットエラー

format_error (C++20)

 

ヘッダー <format> で定義
template< class Context > class basic_format_args;	(1)	(C++20以降)
using format_args = basic_format_args<std::format_context>;	(2)	(C++20以降)
using wformat_args = basic_format_args<std::wformat_context>;	(3)	(C++20以降)

フォーマット引数へのアクセスを提供します。

メンバ関数

(コンストラクタ)	basic_format_args オブジェクトを構築します。 (public member function)
get	指定されたインデックスのフォーマット引数を返します。 (public member function)

std::basic_format_args::basic_format_args

template< class... Args > basic_format_args( const /*format-arg-store*/<Context, Args...>& store ) noexcept;

std::make_format_args または std::make_wformat_args の呼び出し結果から basic_format_args オブジェクトを構築します。

std::basic_format_args::get

std::basic_format_arg<Context> get( std::size_t i ) const noexcept;

std::make_format_args または std::make_wformat_args に渡されたパラメータパックである args の i 番目の引数を含む std::basic_format_arg を返します。

そのようなフォーマット引数がない場合（つまり、*this がデフォルト構築されたか、i がフォーマット引数の数より小さくない場合）、デフォルト構築された std::basic_format_arg（std::monostate オブジェクトを含む）を返します。

推論ガイド

template< class Context, class... Args > basic_format_args( /*format-arg-store*/<Context, Args...> ) -> basic_format_args<Context>;		(C++20以降)

注意

std::basic_format_args は参照セマンティクスを持ちます。プログラマは、*this が store よりも長く生存しないことを保証する責任があります（store は、std::make_format_args または std::make_wformat_args の引数よりも長く生存しないようにする必要があります）。

欠陥報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
P2216R3	C++20	format_args_t は、vformat_to の過剰なパラメータ化のために提供されました。	削除
LWG 3810	C++20	basic_format_args には推論ガイドがありません。	追加された
LWG 4106	C++20	basic_format_args はデフォルト構築可能でした。	デフォルトコンストラクタは削除されました。

関連項目

basic_format_arg (C++20)

ユーザー定義フォーマッタのためにフォーマット引数へのアクセスを提供するクラステンプレート (クラステンプレート)