CKTIS / C++
std::formatter: ugovor formatiranja tipa
Specijalizacija std::formatter<T, charT> određuje raščlambu specifikacije i zapis vrijednosti T.
Verzija: C++23
Sintaksa
template<class T, class CharT = char>
struct std::formatter;
// A usable specialization provides conceptually:
constexpr auto parse(std::basic_format_parse_context<CharT>& ctx);
template<class FormatContext>
auto format(const T& value, FormatContext& ctx) const;std::formatter<T, charT> iz <format> prilagodna je točka koju std::format i povezane funkcije rabe za jedan argument. Formatter zadovoljava BasicFormatter/Formatter: parse(ctx) obrađuje dio nakon dvotočke i vraća prvi nepotrošeni znak, obično }, dok format(value, ctx) zapisuje preko ctx.out() i vraća iterator iza izlaza.
Primjer specijalizira std::formatter<Point> za programski definiran tip. parse vraća ctx.begin(), pa prihvaća samo praznu specifikaciju, a format zapis koordinata prepušta funkciji std::format_to; rezultat je p=(3, 4). Specijalizacija mora biti vidljiva pri provjeri literala. Opcije pročitane u parse mogu se spremiti u formatter i upotrijebiti u format.
Neobrađeni dio specifikacije, osim zaustavljanja na }, zahtijeva std::format_error. Potpis format treba raditi s traženom kvalifikacijom vrijednosti i const formatterom kako bi u C++23 i const vrijednosti bile formatabilne; vraćeni iterator mora biti stvarni kraj izlaza. Specijalizacija je dopuštena za tip programa, ne proizvoljna zamjena specijalizacija standardnih tipova. Kontekst i iteratori ne žive dulje od poziva.
Primjeri
#include <format>
#include <iostream>
struct Point {
int x;
int y;
};
template<>
struct std::formatter<Point> {
constexpr auto parse(std::format_parse_context& ctx) {
return ctx.begin();
}
auto format(const Point& point, std::format_context& ctx) const {
return std::format_to(ctx.out(), "({}, {})", point.x, point.y);
}
};
int main() {
std::cout << std::format("p={}", Point{3, 4}) << '\n';
}
Rezultat
p=(3, 4)
std::formatter → p=(3, 4)