std:: formatter

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

모든 타입 T 와 CharT 에 대해, 특수화 std::formatter<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 > 와 같은 특수화는 비활성화됩니다.

표준 형식 사양

라이브러리 타입을 위한 표준 특수화

예제

#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++ 표준에 소급 적용되었습니다.

참고 항목