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"); // 正常，生成 "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)); // 正确
}
std::string f2(std::string_view runtime_format_string)
{
    return std::format(std::runtime_format(runtime_format_string), "x", 42); // 正确 (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++ 标准。

参见