formattable.md

formattable

• format[meta header]
• concept[meta id-type]
• std[meta namespace]
• cpp23[meta cpp]

namespace std {
  template <class charT>
  concept fmt-iter-for = output_iterator<const charT&>;

  template <class T, class charT>
  concept formattable =
    semiregular<formatter<remove_cvref_t<T>, charT>> &&
    requires(formatter<remove_cvref_t<T>, charT> f,
             const formatter<remove_cvref_t<T>, charT> cf,
             T t,
             basic_format_context<fmt-iter-for<charT>, charT> fc,
             basic_format_parse_context<charT> pc) {
      { f.parse(pc) } -> same_as<basic_format_parse_context<charT>::iterator>;
      { cf.format(t, fc) } -> same_as<fmt-iter-for<charT>>;
    }
  };
}

• formatter[link formatter.md]
• semiregular[link /reference/concepts/semiregular.md]
• remove_cvref_t[link /reference/type_traits/remove_cvref.md]
• basic_format_context[link basic_format_context.md]
• basic_format_parse_context[link basic_format_parse_context.md]
• same_as[link /reference/concepts/same_as.md]

概要

formattableは、文字列フォーマット可能であることを表すコンセプトである。

このコンセプトを使用することで、formatterクラステンプレートが使用したい型で特殊化されているかをチェックできる。

例

#include <iostream>
#include <format>
#include <any>

template <std::formattable<char> T>
void f(T x) {
  std::cout << std::format("{}", x) << std::endl;
}

int main() {
  f(3);       // OK
  f("hello"); // OK
//f(std::any{3}); // NG : std::anyはstd::formatterを特殊化していない
}

• std::format[link format.md]

出力

3
hello

バージョン

言語

• C++23

処理系

• Clang: ??
• GCC: 13
• Visual C++: ??

参照

• P2286R8 Formatting Ranges