CKTIS / C++
std::formatter: oblikovalna pogodba tipa
Specializacija std::formatter<T, charT> določa razčlenitev specifikacije in zapis vrednosti T.
Različica: 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> je prilagoditvena točka, ki jo std::format in sorodne funkcije uporabljajo za posamezen argument. Formatter izpolnjuje BasicFormatter/Formatter: parse(ctx) razčleni del za dvopičjem in vrne prvi neporabljeni znak, navadno }, format(value, ctx) pa piše prek ctx.out() in vrne iterator za izhodom.
Primer specializira std::formatter<Point> za programsko določen tip. parse vrne ctx.begin(), zato sprejme le prazno specifikacijo, format pa zapis koordinat prepusti std::format_to; rezultat je p=(3, 4). Specializacija mora biti vidna ob preverjanju literala. Možnosti iz parse se lahko shranijo v formatter in uporabijo v format.
Neobdelan del specifikacije, razen ustavitve pri }, zahteva std::format_error. Podpis format mora delovati z zahtevano kvalifikacijo vrednosti in const formatterjem, da so v C++23 oblikovljive tudi const vrednosti; vrnjeni iterator mora biti resnični konec izhoda. Specializacija je dovoljena za tip programa, ne poljubna zamenjava specializacij standardnih tipov. Kontekst in iteratorji ne živijo dlje od klica.
Primeri
#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)