Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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)

Viri