Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::formatter: contrato de formato de un tipo

Una especialización std::formatter<T, charT> define cómo analizar la especificación y escribir un valor T.

Versión: C++23

Sintaxis

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> de <format> es el punto de personalización que usan std::format y funciones relacionadas para cada argumento. Un formatter cumple BasicFormatter/Formatter: parse(ctx) analiza la parte posterior a los dos puntos y devuelve el primer carácter no consumido, normalmente }, mientras format(value, ctx) escribe mediante ctx.out() y devuelve el iterador posterior a su salida.

El ejemplo especializa std::formatter<Point> para un tipo del programa. parse devuelve ctx.begin(), por lo que solo acepta especificación vacía, y format delega las coordenadas en std::format_to; el resultado es p=(3, 4). La especialización debe estar visible al comprobar el literal. Las opciones leídas en parse pueden guardarse en el formatter y usarse después en format.

Dejar una parte sin analizar, salvo detenerse en }, exige std::format_error. La firma de format debe admitir la cualificación requerida del valor y un formatter const para que los valores const sean formateables bajo C++23; el iterador devuelto debe ser el fin real de la salida. Se permite especializar para un tipo definido por el programa, pero no sustituir arbitrariamente especializaciones de tipos estándar. El contexto y sus iteradores no sobreviven a la llamada.

Ejemplos

#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';
}

Resultado

p=(3, 4)

std::formatter → p=(3, 4)

Fuentes