vprint_nonunicode.md

vprint_nonunicode

• ostream[meta header]
• std[meta namespace]
• function[meta id-type]
• cpp23[meta cpp]

namespace std {
  void vprint_nonunicode(ostream& os,
                         string_view fmt,
                         format_args args); // (1) C++23
}

• ostream[link basic_ostream.md]
• format_args[link /reference/format/basic_format_args.md]

概要

書式指定で非Unicode出力する。

• (1) : 指定したostreamに、書式指定で非Unicode出力する

デフォルトの標準出力に出力したい場合は、<print>ヘッダのstd::vprint_nonunicode()関数を使用すること。

効果

• osの書式化出力関数として振る舞うが、以下の点が異なる：

  • 出力の生成失敗は、以下で規定されるように報告される
  • vformat()関数よって送出された例外は、os.exceptions()の値に関係なく、またosのエラー状態としてios_base::badbitをオンにすることなく、伝播される。

• sentryオブジェクトを構築した後、以下のように自動変数を初期化する：

  string out = vformat(fmt, args);

  • string[link /reference/string/basic_string.md]
  • vformat[link /reference/format/vformat.md]

• 文字シーケンス [out.begin(), out.end()) を os に挿入する。端末への書き込みまたは os への挿入が失敗した場合、os.setstate(ios_base::badbit) を呼び出す (ios_base::failureが送出される可能性がある)

バージョン

言語

• C++23

処理系

• Clang: 19
• GCC: 14
• ICC: ??
• Visual C++: 2022 Update 7

関連項目

• std::print()
• std::println()
• std::vprint_unicode()

参照

• P2093R14 Formatted output