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++規格に対して遡及的に適用されました。

関連項目