std:: format

형식 문자열 fmt 에 따라 args 를 포맷하고 결과를 문자열로 반환합니다. 존재하는 경우, loc 은 로케일별 포맷팅에 사용됩니다.

형식 문자열 fmt 는 컴파일 타임에 검사됩니다 (단, std::runtime_format 의 결과로 초기화된 경우는 제외) (C++26부터) . 컴파일 타임에 형식 문자열이 포맷할 인수의 타입에 대해 유효하지 않은 것으로 판단되면 컴파일 오류가 발생합니다.

다음 요구 사항들은 Args 내의 각 타입 T 에 적용되며, 여기서 CharT 는 char 인 경우 오버로드 (1,3) 에 해당하고, wchar_t 인 경우 오버로드 (2,4) 에 해당합니다:

• std:: formatter < T, CharT > 는 BasicFormatter 요구사항을 충족해야 합니다.
• std:: formatter < T, CharT > :: parse ( ) 는 컴파일 타임 형식 문자열 검사를 위해 constexpr 이어야 합니다.

매개변수

반환값

형식화된 결과를 담고 있는 문자열 객체.

예외

할당 실패 시 std::bad_alloc 을 발생시킵니다. 또한 모든 포매터(formatter)에서 발생한 예외를 전파합니다.

참고 사항

형식 문자열이 요구하는 것보다 더 많은 인수를 제공하는 것은 오류가 아닙니다:

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)); // 정상
}
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++ 표준에 소급 적용되었습니다.

참고 항목