std:: println (std::ostream)

Definido en el encabezado <ostream>
template < class ... Args > void println ( std:: ostream & os, std:: format_string < Args... > fmt, Args && ... args ) ;	(1)	(desde C++23)
void println ( std:: ostream & os ) ;	(2)	(desde C++26)

Formatea args de acuerdo con la cadena de formato fmt con un ' \n ' añadido (lo que significa que cada salida termina con una nueva línea), e inserta el resultado en el flujo os .

El comportamiento no está definido si std:: formatter < Ti, char > no cumple con los requisitos de BasicFormatter para cualquier Ti en Args (como lo requiere std:: make_format_args ).

Contenidos 1 Parámetros 2 Excepciones 3 Notas 4 Ejemplo 5 Reportes de defectos 6 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

Aunque la sobrecarga ( 2 ) se añade en C++26, todas las implementaciones conocidas la hacen disponible en modo C++23.

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

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

DR	Aplicado a	Comportamiento publicado	Comportamiento correcto
LWG 4088	C++23	( 1 ) ignoraba la configuración regional establecida en os al formatear argumentos	dicha configuración regional se utiliza

Véase también

print (std::ostream) (C++23)	genera representación formateada de los argumentos (plantilla de función)
println (C++23)	igual que std::print excepto que cada impresión termina con una nueva línea adicional (plantilla de función)
format (C++20)	almacena la representación formateada de los argumentos en una nueva cadena (plantilla de función)