format_formatter

format_formatter (서식 지정자 클래스 템플릿)

std::formatter는 주어진 타입에 대한 서식 지정 규칙을 정의하는 클래스 템플릿이에요. C++20에서 도입되었으며, std::format과 같은 형식화 기능에서 타입별 출력 형식을 제어하는 핵심 역할을 해요. 이 페이지에서는 기본 특수화와 표준 형식 지정, 라이브러리 타입에 대한 특수화 등을 다룬답니다.

출처: cppreference

본문

개요

std::formatter의 활성화된 특수화는 주어진 타입에 대한 서식 지정 규칙을 정의해요. 활성화된 특수화는 BasicFormatter 요구 사항을 충족하며, 별도로 명시되지 않는 한 Formatter 요구 사항도 충족해요.

특수화 std::formatter<T, CharT>가 활성화되지 않은 모든 타입 T와 CharT에 대해, 그 특수화는 완전한 타입이며 비활성화되어 있어요.

비활성화된 특수화는 Formatter 요구 사항을 충족하지 않으며, 다음 모두가 false예요:

• std::is_default_constructible_v
• std::is_copy_constructible_v
• std::is_move_constructible_v
• std::is_copy_assignable_v
• std::is_move_assignable_v

기본 표준 특수화

다음 목록에서 CharT는 char 또는 wchar_t이고, ArithmeticT는 char, wchar_t, char8_t, char16_t, char32_t를 제외한 cv 한정되지 않은 산술 타입이에요.

문자 포맷터

문자열 포맷터

산술 포맷터

포인터 포맷터

다른 포인터와 멤버 포인터에 대한 포맷터는 비활성화되어 있어요.

인코딩 변환이 필요한 std::formatter<wchar_t, char>나 std::formatter<const char*, wchar_t> 같은 특수화는 비활성화되어 있어요.

wchar_t에 대한 비활성화된 포맷터 (C++23)

C++23에서는 일부 char 시퀀스가 wchar_t 범위로 서식 지정되는 것을 방지하기 위해 다음 특수화가 여전히 비활성화되어 있어요.

디버그 활성화 포맷터 특수화는 추가로 공용 비정적 멤버 함수 constexpr void set_debug_format();을 제공해요. 이 함수는 마지막 parse 호출에서 파싱된 형식 지정자의 타입이 ?였던 것처럼 값이 이스케이프되고 인용되어 서식 지정되도록 포맷터 객체의 상태를 수정해요. 문자열 또는 문자 타입에 대한 각 포맷터 특수화는 디버그 활성화되어 있어요.

표준 형식 지정

이 섹션은 불완전해요. 이유: 표준 형식 지정은 별도 페이지로 이동되었어요. 섹션 제목은 이 섹션으로의 링크를 위해 임시로 유지되고 있어요. 모든 링크가 정리된 후 이 섹션은 제거될 예정이에요.

라이브러리 타입에 대한 표준 특수화

예제

#include <algorithm>
#include <format>
#include <iomanip>
#include <iostream>
#include <sstream>
#include <string_view>
 
struct QuotableString : std::string_view
{};
 
template<>
struct std::formatter<QuotableString, char>
{
    bool quoted = false;

    template<class ParseContext>
    constexpr ParseContext::iterator parse(ParseContext& ctx)
    {
        auto it = ctx.begin();
        if (it == ctx.end())
            return it;
            
        if (*it == '#')
        {
            quoted = true;
            ++it;
        }
        if (it != ctx.end() && *it != '}')
            throw std::format_error("Invalid format args for QuotableString.");
            
        return it;
    }
 
    template<class FmtContext>
    FmtContext::iterator format(QuotableString s, FmtContext& ctx) const
    {
        std::ostringstream out;
        if (quoted)
            out << std::quoted(s);
        else
            out << s;

        return std::ranges::copy(std::move(out).str(), ctx.out()).out;
    }
};
 
int main()
{
    QuotableString a("be"), a2(R"( " be " )");
    QuotableString b("a question");
    std::cout << std::format("To {0} or not to {0}, that is {1}.\n", a, b);
    std::cout << std::format("To {0:} or not to {0:}, that is {1:}.\n", a, b);
    std::cout << std::format("To {0:#} or not to {0:#}, that is {1:#}.\n", a2, b);
}

출력:

To be or not to be, that is a question.
To be or not to be, that is a question.
To " \" be \" " or not to " \" be \" ", that is "a question".

결함 보고서

다음 동작 변경 결함 보고서는 이전에 발표된 C++ 표준에 소급 적용되었어요.

같이 보기

더 알아보기 (Learn more)

cppreference