std::vprint_unicode(std::ostream)

void vprint_unicode( std::ostream& os,
                     std::string_view fmt, std::format_args args );

Форматирует args в соответствии со строкой формата fmt и записывает результат в выходной поток os. Ведёт себя как функция форматированного вывода для os, за исключением того, что некоторые детали обработки ошибок отличаются.

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

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

• Если os ссылается на терминал, способный отображать Unicode только с помощью собственного API Unicode, сбрасывает os и записывает out в терминал с помощью собственного API Unicode.
• В противном случае вставляет последовательность символов [out.begin(), out.end()) в os.

Если запись в терминал или вставка в os завершается неудачей, вызывает os.setstate(std::ios_base::badbit).

Если out содержит недопустимые единицы кода Unicode кодовые единицы при использовании собственного API Unicode, поведение не определено.

Параметры

Исключения

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

Примечания

Если для вызова собственного API Unicode требуется транскодирование, недопустимые единицы кода заменяются на U+FFFD REPLACEMENT CHARACTER (см. «Стандарт Unicode — основная спецификация», главу 3.9).

Пример

Отчёты об исправлениях

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

См. также

Внешние ссылки