std:: format_to

書式文字列 fmt に従って args をフォーマットし、結果を出力イテレータ out に書き込みます。指定されている場合、 loc はロケール固有のフォーマットに使用されます。

次と同等：

CharT を char とするのはオーバーロード (1,3) の場合、 wchar_t とするのはオーバーロード (2,4) の場合です。

これらのオーバーロードは、 OutputIt がコンセプト std:: output_iterator < const CharT & > を満たす場合にのみ、オーバーロード解決に参加します。

以下のいずれかの条件が満たされる場合、動作は未定義です：

• OutputIt は std:: output_iterator < const CharT & > をモデル化しません。
• std:: formatter < Ti, CharT > が一部の Args 内の Ti について BasicFormatter 要件（ std::make_format_args および std::make_wformat_args で要求される）を満たしていません。

パラメータ

戻り値

出力範囲の終端を超えたイテレータ。

例外

formatterまたはiterator操作によってスローされた例外を伝播します。

注記

書式文字列が定数式でない場合はエラーです 、 std::runtime_format の結果から初期化されている場合を除きます (C++26以降) 。 std::vformat_to にはこの要件はありません。

例

#include <format>
#include <iostream>
#include <iterator>
#include <string>
int main()
{
    std::string buffer;
    std::format_to
    (
        std::back_inserter(buffer), // < OutputIt
        "Hello, C++{}!\n",          // < fmt
        "20"                        // < arg
    );
    std::cout << buffer;
    buffer.clear();
    std::format_to
    (
        std::back_inserter(buffer), // < OutputIt
        "Hello, {0}::{1}!{2}",      // < fmt
        "std",                      // < arg {0}
        "format_to()",              // < arg {1}
        "\n",                       // < arg {2}
        "extra param(s)..."         // < unused
    );
    std::cout << buffer << std::flush;
    std::wstring wbuffer;
    std::format_to
    (
        std::back_inserter(wbuffer),// < OutputIt
        L"Hello, {2}::{1}!{0}",     // < fmt
        L"\n",                      // < arg {0}
        L"format_to()",             // < arg {1}
        L"std",                     // < arg {2}
        L"...is not..."             // < unused
        L"...an error!"             // < unused
    );
    std::wcout << wbuffer;
}

Hello, C++20!
Hello, std::format_to()!
Hello, std::format_to()!

欠陥報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目