Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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)

Zdroje