std:: format

書式文字列 fmt に従って args をフォーマットし、結果を文字列として返します。存在する場合、 loc はロケール固有のフォーマットに使用されます。

書式文字列 fmt はコンパイル時にチェックされます （ std::runtime_format の結果から初期化された場合を除く） (C++26以降) 。コンパイル時に、書式文字列がフォーマット対象の引数の型に対して無効であることが判明した場合、コンパイルエラーが発生します。

以下の要件は、 Args 内の各型 T に適用されます。ここで CharT は、オーバーロード (1,3) では char 、オーバーロード (2,4) では wchar_t です：

• std:: formatter < T, CharT > は BasicFormatter を満たさなければならない
• std:: formatter < T, CharT > :: parse ( ) はコンパイル時フォーマット文字列チェックの目的で constexpr でなければならない

パラメータ

戻り値

フォーマットされた結果を保持する文字列オブジェクト。

例外

確保に失敗した場合は std::bad_alloc をスローします。また、任意のフォーマッタによってスローされた例外を伝播します。

注記

フォーマット文字列が必要とする以上の引数を提供してもエラーにはなりません：

std::format("{} {}!", "Hello", "world", "something"); // OK、「Hello world!」を生成

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

std::string f1(std::string_view runtime_format_string)
{
    // return std::format(runtime_format_string, "x", 42); // エラー
    char v1[] = "x";
    int v2 = 42;
    return std::vformat(runtime_format_string, std::make_format_args(v1, v2)); // OK
}
std::string f2(std::string_view runtime_format_string)
{
    return std::format(std::runtime_format(runtime_format_string), "x", 42); // OK (C++26)
}

例

#include <format>
#include <iostream>
#include <set>
#include <string>
#include <string_view>
template<typename... Args>
std::string dyna_print(std::string_view rt_fmt_str, Args&&... args)
{
    return std::vformat(rt_fmt_str, std::make_format_args(args...));
}
int main()
{
#ifdef __cpp_lib_format_ranges
        const std::set<std::string_view> continents 
        {
            "Africa",   "America",      "Antarctica",   
            "Asia",     "Australia",    "Europe"
        };
        std::cout << std::format("Hello {}!\n", continents);
#else
        std::cout << std::format("Hello {}!\n", "continents");
#endif
    std::string fmt;
    for (int i{}; i != 3; ++i)
    {
        fmt += "{} "; // フォーマット文字列を構築
        std::cout << fmt << " : ";
        std::cout << dyna_print(fmt, "alpha", 'Z', 3.14, "unused");
        std::cout << '\n';
    }
}

Hello {"Africa", "America", "Antarctica", "Asia", "Australia", "Europe"}!
{}  : alpha
{} {}  : alpha Z
{} {} {}  : alpha Z 3.14

不具合報告

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

関連項目