std:: vprint_nonunicode (std::ostream)

Definido en el encabezado <ostream>
void vprint_nonunicode ( std:: ostream & os, std:: string_view fmt, std:: format_args args ) ;		(desde C++23)

Se comporta como una FormattedOutputFunction (excepto que algunos detalles del reporte de errores difieren ).

Realiza las siguientes operaciones en orden:

1. Primero, construye y verifica el objeto sentry .
2. Luego, inicializa una variable automática como si fuera mediante std:: string out = std:: vformat ( os. getloc ( ) , fmt, args ) ; .
3. Finalmente, inserta la secuencia de caracteres [ out. begin ( ) , out. end ( ) ) en os .

Después de escribir caracteres en os , establece un punto de control observable .

(since C++26)

Contenidos 1 Parámetros 2 Excepciones 3 Notas 4 Ejemplo 5 Véase también

Parámetros

os	-	flujo de salida donde insertar los datos
fmt	-	un objeto que representa la cadena de formato. La cadena de formato consiste en: caracteres ordinarios (excepto { y } ), que se copian sin cambios a la salida, secuencias de escape { { y } } , que se reemplazan con { y } respectivamente en la salida, y campos de reemplazo. Cada campo de reemplazo tiene el siguiente formato: { arg-id (opcional) } (1) { arg-id (opcional) : format-spec } (2) 1) campo de reemplazo sin especificación de formato 2) campo de reemplazo con especificación de formato arg-id - especifica el índice del argumento en args cuyo valor se usará para el formato; si se omite, los argumentos se usan en orden. Los arg-id s en una cadena de formato deben estar todos presentes o todos omitidos. Mezclar indexación manual y automática es un error. format-spec - la especificación de formato definida por la especialización de std::formatter para el argumento correspondiente. No puede comenzar con } . Para tipos básicos y tipos de cadena estándar, la especificación de formato se interpreta como especificación de formato estándar . Para tipos chrono, la especificación de formato se interpreta como especificación de formato chrono . Para tipos de rango, la especificación de formato se interpreta como especificación de formato de rango . Para std::pair y std::tuple , la especificación de formato se interpreta como especificación de formato de tupla . Para std::thread::id y std::stacktrace_entry , ver especificación de formato de thread id y especificación de formato de stacktrace entry . Para std::basic_stacktrace , no se permite ningún especificador de formato. (desde C++23) Para std::filesystem::path , ver especificación de formato de path . (desde C++26) Para otros tipos formateables, la especificación de formato está determinada por especializaciones de formatter definidas por el usuario.
args	-	argumentos a formatear

Excepciones

• std::bad_alloc en caso de fallo de asignación.
• Propaga cualquier excepción lanzada por cualquier formatter , por ejemplo std::format_error , sin tener en cuenta el valor de os. exceptions ( ) y sin activar ios_base::badbit en el estado de error de os .
• Puede lanzar ios_base::failure causado por os. setstate ( ios_base :: badbit ) que se llama si una inserción en os falla.

Notas

Macro de prueba de características	Valor	Std	Característica
__cpp_lib_print	202207L	(C++23)	Salida formateada
__cpp_lib_format	202207L	(C++23)	Exponer std::basic_format_string

Ejemplo

Esta sección está incompleta Razón: sin ejemplo

Véase también

vprint_unicode (std::ostream) (C++23)	realiza salida compatible con Unicode usando representación de argumentos con borrado de tipo (función)
print (std::ostream) (C++23)	genera representación formateada de los argumentos (plantilla de función)
operator<< (std::basic_ostream)	inserta datos de caracteres o inserta en flujo de valor R (plantilla de función)
vprint_nonunicode vprint_nonunicode_buffered (C++23)	imprime en stdout o un flujo de archivo usando representación de argumentos con borrado de tipo (función)
format (C++20)	almacena representación formateada de los argumentos en una nueva cadena (plantilla de función)