std::println(std::ostream)

Определено в заголовочном файле `<ostream>`
template< class... Args > void println( std::ostream& os, std::format_string<Args...> fmt, Args&&... args );	(1)	(начиная с C++23)
void println( std::ostream& os );	(2)	(начиная с C++26)

Форматирует args в соответствии со строкой формата fmt с добавленным '\n' (это означает, что каждый вывод завершается символом новой строки) и вставляет результат в поток os.

1) Эквивалентно: std::print(os,"{}\n",std::format(os.getloc(),fmt,args...));

2) Эквивалентно: std::print(os,"\n");

Поведение не определено, если std::formatter<Ti,char> не соответствует требованиям BasicFormatter для любого Ti в Args (как того требует std::make_format_args).

Параметры

os - выходной поток, в который вставляются данные

fmt

объект, представляющий строку формата. Строка формата состоит из

обычных символов (кроме { и }), которые без изменений копируются в выходные данные,
управляющих последовательностей {{ и }}, которые заменяются в выходных данных соответственно на { и }, и
полей подстановки.

Каждое поле подстановки имеет следующий формат:

`{` arg-id (необязательно) `}`	(1)
`{` arg-id (необязательно) `:` format-spec `}`	(2)

1) поле подстановки без спецификации формата 2) поле подстановки со спецификацией формата

arg-id	-	задаёт индекс аргумента в `args`, значение которого будет использовано для форматирования; если он опущен, аргументы используются по порядку. Все значения arg-id в строке формата должны быть либо указаны, либо опущены. Смешение ручной и автоматической индексации является ошибкой.
format-spec	-	спецификация формата, определённая специализацией `std::formatter` для соответствующего аргумента. Не может начинаться с `}`.

Для базовых типов и стандартных строковых типов спецификация формата интерпретируется как стандартная спецификация формата.
Для типов chrono спецификация формата интерпретируется как спецификация формата chrono.

Для типов-диапазонов спецификация формата интерпретируется как спецификация формата диапазона.
Для std::pair и std::tuple спецификация формата интерпретируется как спецификация формата кортежа.
Для std::thread::id и std::stacktrace_entry см. спецификацию формата идентификатора потока и спецификацию формата записи трассировки стека.
Для std::basic_stacktrace спецификатор формата не допускается.

(начиная с C++23)

Для std::filesystem::path см. спецификацию формата пути.

(начиная с C++26)

Для других форматируемых типов спецификация формата определяется пользовательскими специализациями formatter.

args... - аргументы для форматирования

Исключения

std::bad_alloc при ошибке выделения памяти.
Распространяет любое исключение, выброшенное любым форматтером, например std::format_error, независимо от значения os.exceptions() и не устанавливая ios_base::badbit в состоянии ошибки os.
Может выбросить ios_base::failure, вызванное os.setstate(ios_base::badbit), которое вызывается, если вставка в os завершается неудачей.

Примечания

Хотя перегрузка (2) добавлена в C++26, все известные реализации предоставляют её в режиме C++23.

Макрос проверки поддержки	Значение	Стандарт	Возможность
`__cpp_lib_print`	`202207L`	(C++23)	Форматированный вывод
`__cpp_lib_format`	`202207L`	(C++23)	Предоставление `std::basic_format_string`

Пример

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были ретроактивно применены к ранее опубликованным стандартам C++.

Отчёт об ошибке	Применён к	Опубликованное поведение	Корректное поведение
LWG 4088	C++23	(1) игнорировала локаль, заданную для `os`, при форматировании аргументов	такая локаль используется

См. также

print(std::ostream) (C++23)	выводит форматированное представление аргументов (шаблон функции)
println (C++23)	то же, что и `std::print`, за исключением того, что после каждого вывода добавляется символ новой строки (шаблон функции)
format (C++20)	сохраняет форматированное представление аргументов в новой строке (шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/io/basic_ostream/println