名前空間
変種

    std::format_to_n

    提供: cppreference.com
     
    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)
    (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)
     
    <tbody> </tbody>
    ヘッダ <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

    関連項目