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

CKTIS / C++

std::format: formato tipado en una cadena nueva

std::format crea un std::string nuevo a partir de un patrón comprobado y sus argumentos.

Versión: C++23

Sintaxis

template<class... Args>
std::string std::format(std::format_string<Args...> fmt, Args&&... args);

template<class... Args>
std::wstring std::format(std::wformat_string<Args...> fmt, Args&&... args);

template<class... Args>
std::string std::format(const std::locale& loc,
    std::format_string<Args...> fmt, Args&&... args);

template<class... Args>
std::wstring std::format(const std::locale& loc,
    std::wformat_string<Args...> fmt, Args&&... args);

std::format(fmt, args...) de <format> devuelve un std::string nuevo con las representaciones de los argumentos en campos de sustitución; la variante de caracteres anchos devuelve std::wstring y otras sobrecargas aceptan std::locale. En C++23 una llamada normal usa format_string<Args...>, cuyo literal se comprueba durante la compilación frente al número y los tipos de argumentos.

El ejemplo formatea 7 como 0007, 3.5 con dos cifras fraccionarias y llaves dobles como texto literal, e imprime 0007 3.50 {ok}. {} selecciona el siguiente argumento y la parte tras : controla alineación, anchura, precisión y tipo de presentación. std::format devuelve otra cadena; std::format_to escribe mediante un iterador de salida.

Las llaves literales se escriben {{ y }}; no se puede mezclar numeración automática {} con manual {0}. Un literal inválido o un especificador incompatible suele hacer que la llamada sea errónea al compilar. Para un patrón conocido solo en ejecución usa std::vformat. El propio std::format también puede lanzar std::format_error por un fallo dependiente de valores detectado en ejecución, como una anchura o precisión dinámica inválida; las excepciones de operaciones del formatter se propagan y la asignación puede lanzar std::bad_alloc. Un tipo propio necesita una especialización válida de std::formatter; el formato regional usa la sobrecarga con std::locale y opciones adecuadas.

Ejemplos

#include <format>
#include <iostream>

int main() {
    std::cout << std::format("{:04} {:.2f} {{ok}}", 7, 3.5) << '\n';
}

Resultado

0007 3.50 {ok}

std::format → 0007 3.50 {ok}

Fuentes