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

CKTIS / C++

std::format_to: formato mediante un iterador de salida

std::format_to escribe caracteres formateados mediante un iterador de salida y devuelve el iterador posterior a la última escritura.

Versión: C++23

Sintaxis

template<class Out, class... Args>
Out std::format_to(Out out, std::format_string<Args...> fmt, Args&&... args);

template<class Out, class... Args>
Out std::format_to(Out out, std::wformat_string<Args...> fmt, Args&&... args);

template<class Out, class... Args>
Out std::format_to(Out out, const std::locale& loc,
    std::format_string<Args...> fmt, Args&&... args);

template<class Out, class... Args>
Out std::format_to(Out out, const std::locale& loc,
    std::wformat_string<Args...> fmt, Args&&... args);

std::format_to(out, fmt, args...) de <format> da formato como std::format, pero no crea una cadena resultado: asigna los caracteres sucesivos mediante out. Devuelve el iterador inmediatamente posterior al último carácter escrito. Hay formas para caracteres estrechos y anchos, además de sobrecargas que reciben std::locale.

El ejemplo escribe "2 + 3 = 5" al principio de un array de caracteres y resta el inicio al iterador devuelto para obtener 9 caracteres escritos, por lo que imprime 2 + 3 = 5|9. No añade terminador nulo; la vista recibe una longitud explícita. Para un contenedor que crece, el destino habitual es std::back_inserter.

El iterador de destino debe aceptar el tipo de carácter correcto y seguir siendo escribible para todo el resultado. En un búfer insuficiente, un iterador normal deja de cumplir los requisitos de iterador de salida y las escrituras posteriores tienen comportamiento indefinido; format_to no conoce la capacidad. Un format_string literal se comprueba con los argumentos. Los fallos pueden lanzar std::format_error, la asignación std::bad_alloc, y se propagan las excepciones del formatter o iterador. Para imponer un límite de escritura usa std::format_to_n.

Ejemplos

#include <array>
#include <format>
#include <iostream>
#include <string_view>

int main() {
    std::array<char, 32> buffer{};
    const auto end = std::format_to(buffer.begin(), "{} + {} = {}", 2, 3, 5);
    const std::string_view result(buffer.data(), end - buffer.begin());
    std::cout << result << '|' << result.size() << '\n';
}

Resultado

2 + 3 = 5|9

std::format_to → 2 + 3 = 5|9

Fuentes