CKTIS / C++
std::formatter: formátovací kontrakt typu
Špecializácia std::formatter<T, charT> určuje parsovanie špecifikácie a zápis hodnoty T.
Verzia: C++23
Syntax
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> z <format> je bod prispôsobenia, ktorý std::format a súvisiace funkcie používajú pre jeden argument. Formatter spĺňa BasicFormatter/Formatter: parse(ctx) spracuje časť za dvojbodkou a vráti prvý nespotrebovaný znak, obyčajne }, zatiaľ čo format(value, ctx) zapisuje cez ctx.out() a vráti iterátor za výstupom.
Príklad špecializuje std::formatter<Point> pre typ programu. parse vracia ctx.begin(), takže prijíma iba prázdnu špecifikáciu, a format odovzdá zápis súradníc do std::format_to; výsledok je p=(3, 4). Špecializácia musí byť viditeľná pri kontrole literálu. Voľby prečítané v parse možno uložiť vo formatteri a použiť vo format.
Nespracovaná časť špecifikácie okrem zastavenia na } vyžaduje std::format_error. Signatúra format má pracovať s požadovanou kvalifikáciou hodnoty a const formatterom, aby boli v C++23 formátovateľné aj const hodnoty; vrátený iterátor musí byť skutočný koniec výstupu. Špecializácia je povolená pre typ definovaný programom, nie ľubovoľná náhrada špecializácií štandardných typov. Kontext ani iterátory neprežívajú volanie.
Príklady
#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';
}
Výsledok
p=(3, 4)
std::formatter → p=(3, 4)