std::formatter<range>

 

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)

 

std::formatter<range>

range-default-formatter の特殊化

range-default-formatter<std::range_format::sequence>

range-default-formatter<std::range_format::map>

range-default-formatter<std::range_format::set>

range-default-formatter<std::range_format::string> range-default-formatter<std::range_format::debug_string>

 

ヘッダー <format> で定義
template< ranges::input_range R, class CharT >     requires (std::format_kind<R> != std::range_format::disabled) &&               std::formattable<ranges::range_reference_t<R>, CharT> struct formatter<R, CharT>;		(C++23から)
ヘルパーテンプレート
template< std::range_format K, ranges::input_range R, class CharT > struct /*range-default-formatter*/;		(説明用*)

range の std::formatter のテンプレート特殊化により、ユーザーは range を要素のコレクションまたは文字列としてのテキスト表現に、フォーマット関数を使用して変換できます。

この特殊化は、range-default-formatter<std::format_kind<R>, R, CharT>から派生しています。

この特殊化は、R が input_range を満たし、std::format_kind<R> が std::range_format::disabled でなく、std::formattable<ranges::range_reference_t<R>, CharT> が true の場合に有効になります。

この特殊化は、const R が input_range をモデル化し、ranges::range_reference_t<const R> が std::formattable<CharT> をモデル化する場合に、Formatter の要件を満たします。これは常に BasicFormatter の要件を満たします。

フォーマット指定子

range-format-spec の構文は次のとおりです。

range-fill-and-align (省略可能) width (省略可能) n(省略可能) range-type (省略可能) range-underlying-spec (省略可能)

構文の詳細は、range フォーマット指定子で説明されています。

std::format_kind<R> が std::range_format::string または std::range_format::debug_string のいずれかである std::formatter の特殊化では、format-spec は range-format-spec の代わりに std-format-spec となります（これは、基盤となるフォーマッタとして std::formatter<std::basic_string<CharT>, CharT> を使用します）。

range-default-formatter の特殊化

range-default-formatter<std::range_format::sequence> (C++23)	シーケンス形式の range のフォーマットユーティリティ (クラステンプレート特殊化)
range-default-formatter<std::range_format::map> (C++23)	マップ形式の range のフォーマットユーティリティ (クラステンプレート特殊化)
range-default-formatter<std::range_format::set> (C++23)	セット形式の range のフォーマットユーティリティ (クラステンプレート特殊化)
range-default-formatter<std::range_format::string>range-default-formatter<std::range_format::debug_string> (C++23)	文字列形式またはエスケープ文字列形式の range のフォーマットユーティリティ (クラステンプレート特殊化)

関連項目

formatter (C++20)	与えられた型のフォーマット規則を定義する (クラステンプレート)
range_formatter (C++23)	範囲型の std::formatter 特殊化の実装を助けるクラステンプレート (クラステンプレート)