vprint_nonunicode(std::ostream)

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

Ведёт себя как FormattedOutputFunction (за исключением некоторых деталей обработки ошибок отличаются):

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

os - поток вывода для вставки данных

fmt

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

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

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

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

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

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

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

(с C++23)

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

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

(нет)

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

Макрокоманда проверки наличия функции	Значение	Std	Функция
`__cpp_lib_print`	202207L	(C++23)	Форматированный вывод
`__cpp_lib_format`	202207L	(C++23)	Представление `std::basic_format_string`

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

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