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

CKTIS / C++

std::vformat — formato con una cadena de formato determinada en tiempo de ejecución

std::vformat de <format> construye una cadena a partir de una cadena de formato y un paquete de argumentos std::format_args. Acepta un patrón determinado en tiempo de ejecución e indica mediante std::format_error los formatos no válidos para los argumentos proporcionados.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <format>
std::string std::vformat(std::string_view fmt, std::format_args args);
std::wstring std::vformat(std::wstring_view fmt, std::wformat_args args);
std::string std::vformat(const std::locale& loc, std::string_view fmt, std::format_args args);
std::wstring std::vformat(const std::locale& loc, std::wstring_view fmt, std::wformat_args args);

std::vformat devuelve una cadena nueva en lugar de escribir en un flujo. Acepta una cadena de formato y un paquete de argumentos con los tipos borrados. La sobrecarga con std::string_view devuelve std::string; la sobrecarga con std::wstring_view usa std::wformat_args y devuelve std::wstring. Las sobrecargas que reciben std::locale admiten el formato dependiente de la configuración regional.

En C++23, std::format normalmente comprueba la cadena de formato en tiempo de compilación. En cambio, std::vformat acepta un patrón que solo está disponible en tiempo de ejecución. Una sintaxis no válida, la ausencia de un argumento referenciado o un especificador incompatible con el tipo del argumento provoca std::format_error. También pueden propagarse excepciones de los formateadores y fallos de asignación de memoria.

Crea el paquete con std::make_format_args usando variables con nombre. No lo consideres propietario de todos los valores: puede conservar referencias a los datos de los argumentos. Esos datos deben seguir siendo válidos hasta que termine el formato, y std::format_args por sí mismo no prolonga la vida del almacenamiento creado por std::make_format_args. Pasar ese almacenamiento directamente a la llamada, como en el ejemplo, evita que se destruya demasiado pronto.

En el ejemplo, {} inserta label, mientras que {:04d} escribe count en decimal con una anchura mínima de cuatro caracteres y ceros iniciales. La salida es item: 0007, seguida de un salto de línea. Esta entrada corresponde a C++23; la referencia proporcionada apunta a un borrador de trabajo en evolución que puede incluir cambios posteriores. Una opción del compilador en un repositorio no demuestra que la biblioteca esté disponible en el entorno de producción.

Ejemplos

#include <format>
#include <iostream>
#include <string>

int main() {
    std::string pattern = "{}: {:04d}";
    std::string label = "item";
    int count = 7;

    std::string result = std::vformat(
        pattern, std::make_format_args(label, count));
    std::cout << result << '\n';
}

Resultado

item: 0007

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes