std::vprint_nonunicode(std::ostream)

Определено в заголовке `<ostream>`
void vprint_nonunicode( std::ostream& os, std::string_view fmt, std::format_args args );		(начиная с C++23)

Выполняет следующие операции по порядку:

Сначала создаёт объект sentry и проверяет его.
Затем инициализирует автоматическую переменную, как если бы выполнялось std::string out = std::vformat(os.getloc(), fmt, args);.
Наконец, вставляет последовательность символов [out.begin(), out.end()) в os.

После записи символов в os устанавливает наблюдаемую контрольную точку.

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

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

fmt

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

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

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

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

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

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

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

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

(начиная с 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.

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

vprint_unicode(std::ostream) (C++23)	выполняет вывод с учётом Unicode, используя представление аргументов с устранённой типизацией (функция)
print(std::ostream) (C++23)	выводит форматированное представление аргументов (шаблон функции)
operator<<(std::basic_ostream)	вставляет символьные данные или выполняет вставку в поток rvalue (шаблон функции)
vprint_nonunicodevprint_nonunicode_buffered (C++23)	выводит в `stdout` или файловый поток, используя представление аргументов с устранённой типизацией (функция)
format (C++20)	сохраняет форматированное представление аргументов в новой строке (шаблон функции)

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