名前空間
変種
操作

std::format_to_n

提供: cppreference.com
< cpp‎ | utility‎ | format
 
C++
 
ユーティリティライブラリ
汎用ユーティリティ
日付と時間
関数オブジェクト
書式化ライブラリ (C++20)
(C++11)
(C++14)
関係演算子 (C++20で非推奨)
整数比較関数
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
(C++20)
スワップと型操作
(C++20)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)
(C++17)
一般的な語彙の型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)

初等文字列変換
(C++17)
(C++17)
(C++17)
 
書式化ライブラリ
書式化関数
(C++20)
(C++20)
format_to_n
(C++20)
(C++20)
(C++20)
(C++20)
フォーマッタ
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
書式化引数
(C++20)
(C++20)(C++20)(C++20)(C++20)
(C++20)
(C++20)(C++20)
書式化エラー
(C++20)
 
ヘッダ <format> で定義
template<class OutputIt, class... Args>

std::format_to_n_result<OutputIt>
    format_to_n(OutputIt out, std::iter_difference_t<OutputIt> n,

                std::string_view fmt, const Args&... args);
 (1) (C++20以上)
template<class OutputIt, class... Args>

std::format_to_n_result<OutputIt>
    format_to_n(OutputIt out, std::iter_difference_t<OutputIt> n,

                std::wstring_view fmt, const Args&... args);
 (2) (C++20以上)
template<class OutputIt, class... Args>

std::format_to_n_result<OutputIt>
    format_to_n(OutputIt out, std::iter_difference_t<OutputIt> n,

                const std::locale& loc, std::string_view fmt, const Args&... args);
 (3) (C++20以上)
template<class OutputIt, class... Args>

std::format_to_n_result<OutputIt>
    format_to_n(OutputIt out, std::iter_difference_t<OutputIt> n,

                const std::locale& loc, std::wstring_view fmt, const Args&... args);
 (4) (C++20以上)
template<class OutputIt>

struct format_to_n_result {
    OutputIt out;
    std::iter_difference_t<OutputIt> size;

};
 (5) (C++20以上)

書式文字列 fmt に従って args を初期化し、結果を出力イテレータ out に出力します。 最大 n 個の文字が出力されます。 存在する場合は、ロケール固有の書式化のために loc が使用されます。

CharT を decltype(fmt)::char_type (オーバーロード (1,3) の場合は char、オーバーロード (2,4) の場合は wchar_t) とします。

これらのオーバーロードは、 OutputIt がコンセプト std::output_iterator<const CharT&> を満たす 場合にのみ、オーバーロード解決に参加します。 OutputIt がコンセプト std::output_iterator<const CharT&> をモデル化しない (意味論の要件を満たさない) 場合、または std::formatter<Ti, CharT> が Args 内の任意の Ti について Formatter の要件を満たさない場合、動作は未定義です。

5) std::format_to_n_result は基底クラスまたは out、 size および暗黙に宣言された特別なメンバ関数以外のメンバを持って���ません。

目次

[編集] 引数

out - 出力バッファを指すイテレータ。
n - バッファに出力する最大文字数。
fmt - 書式文字列を表す文字列ビュー。
[edit]
書式文字列は以下から構成されます。
  • 普通の文字 ({ および } を除きます)。 そのまま出力にコピーされます。
  • エスケープシーケンス {{ および }}。 出力中ではそれぞれ { および } に置き換えられます。
  • 置換フィールド。

置換フィールドは以下の形式を持ちます。

  • 最初の { 文字。
  • (オプション) arg-id。 非負の数値。
  • (オプション) コロン (:) とそれに続く書式指定。
  • 最後の } 文字。

arg-id は書式化に使用する値を持つ args 内の引数のインデックスを指定します。 arg-id が省略された場合は、順番に引数が使用されます。 書式文字列中の arg-id は、すべて存在するか、すべて省略するかでなければなりません。 手動インデックスと自動インデックスの混合はエラーです。

書式指定は対応する引数のための std::formatter の特殊化によって定義されます。

  • 基本型および標準の文字列型の場合、書式指定は標準の書式指定の通りに解釈されます。
  • chrono 型の場合、書式指定は chrono の書式指定の通りに解釈されます。
  • その他の書式化可能な型の場合、書式指定はユーザ定義の formatter の特殊化によって決定されます。


args... - 書式化する引数。
loc - ロケール固有の書式化のために使用される std::locale。

[編集] 戻り値

out メンバが出力範囲の終端を指すイテレータであり size メンバが合計 (切り捨てられていない) 出力サイズであるような format_to_n_result。

[編集] 例外

fmt が有効な書式文字列でない場合、 std::format_error を投げます。 いずれかのフォーマッタによって投げられた例外も伝播されます。

[編集] 例

This section is incomplete
Reason: no example

[編集] 関連項目

「https://ja.cppreference.com/mwiki/index.php?title=cpp/utility/format/format_to_n&oldid=49441」から取得