std::basic_format_context
提供: cppreference.com
ヘッダ <format> で定義
|
||
template<class OutputIt, class CharT> class basic_format_context; |
(1) | (C++20以上) |
using format_context = basic_format_context</* unspecified */, char>; |
(2) | (C++20以上) |
using wformat_context = basic_format_context</* unspecified */, wchar_t>; |
(3) | (C++20以上) |
書式化引数および出力イテレータから構成される書式化状態へのアクセスを提供します。
OutputIt
が std::output_iterator<const CharT&>
をモデル化しない場合、動作は未定義です。
2) 未規定のテンプレート引数は std::back_insert_iterator<std::string> などの std::string への追加を行う出力イテレータです。 処理系は任意の隣接したサイズ可変のコンテナへの追加をサポートする型消去されたバッファ型へのイテレータを使用することが推奨されます。
3) 未規定のテンプレート引数は std::wstring への追加を行う出力イテレータです。
目次 |
[編集] メンバ型
型 | 定義 |
iterator
|
OutputIt
|
char_type
|
CharT
|
[編集] メンバエイリアステンプレート
型 | 定義 |
formatter_type<T>
|
std::formatter<T, CharT> |
[編集] メンバ関数
arg |
指定されたインデックスの引数を返します。 (パブリックメンバ関数) |
locale |
ロケール固有の書式化のために使用するロケールを返します。 (パブリックメンバ関数) |
out |
出力バッファへのイテレータを返します。 (パブリックメンバ関数) |
advance_to |
出力イテレータを指定された位置まで前進させます。 (パブリックメンバ関数) |
std::basic_format_context::arg
std::basic_format_arg<basic_format_context> arg(std::size_t id) const; |
||
args
内の id
番目の引数を保持する std::basic_format_arg
を返します。 ただし args
は書式化関数に渡されたパラメータパックまたは std::basic_format_args
オブジェクトです。
id
が書式化引数の数より小さくない場合は、デフォルト構築された std::basic_format_arg
(std::monostate オブジェクトを保持します) を返します。
std::basic_format_context::locale
std::locale locale(); |
||
書式化関数に渡されたロケール、または書式化関数がロケールを取らない場合はデフォルト構築された std::locale を返します。
std::basic_format_context::out
iterator out(); |
||
出力バッファへのイテレータを返します。
std::basic_format_context::advance_to
void advance_to(iterator it); |
||
出力イテレータを it
に設定します。 advance_to
の呼び出しの後に out()
を呼び出すと it
のコピーを返します。
[編集] 例
This section is incomplete Reason: no example |