Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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)

Izvori