std::vprint_unicode(std::ostream)

ヘッダ`<ostream>`で定義
void vprint_unicode( std::ostream& os, std::string_view fmt, std::format_args args );		(C++23から)

フォーマット文字列 fmt に従って args をフォーマットし、その結果を出力ストリーム os に書き込みます。os の FormattedOutputFunction として動作しますが、エラー報告の詳細は異なります。

以下の操作を順番に実行します

もし os が、ネイティブ Unicode API 経由で Unicode の表示のみが可能な端末を参照している場合、os をフラッシュし、out をネイティブ Unicode API を使用して端末に書き込みます。
それ以外の場合、文字シーケンス [out.begin(), out.end()) を os に挿入します。

端末への書き込みまたは os への挿入が失敗した場合、os.setstate(std::ios_base::badbit) を呼び出します。

os に文字を書き込んだ後、観測可能なチェックポイントを確立します。

(C++26以降)

ネイティブ Unicode API が使用される際に out が無効な Unicode コードユニットを含む場合、動作は未定義です。

arg-id	-	フォーマットに使用する `args` 内の引数のインデックスを指定する。省略された場合、引数は順番に使用される。フォーマット文字列内の arg-id は、すべて存在するか、すべて省略されなければならない。手動と自動のインデックス付けを混在させることはエラーである。
format-spec	-	対応する引数に対する std::formatter 特殊化によって定義されるフォーマット指定。} で開始することはできない。

範囲型の場合、フォーマット指定は範囲フォーマット指定として解釈される。
std::pair および std::tuple の場合、フォーマット指定はtupleフォーマット指定として解釈される。
std::thread::id および std::stacktrace_entry の場合、スレッドIDフォーマット指定およびスタックトレースエントリフォーマット指定を参照。
std::basic_stacktrace の場合、フォーマット指定子は許可されない。

(C++23から)

(C++26以降)

args - フォーマットする引数

アロケーションに失敗した場合、std::bad_alloc。
os.exceptions() の値に関係なく、また os のエラー状態に ios_base::badbit を設定することなく、いずれかの formatter によってスローされた例外（例: std::format_error）を伝播します。
os への挿入が失敗した場合に呼び出される os.setstate(ios_base::badbit) によって引き起こされる ios_base::failure をスローする可能性があります。

ネイティブ Unicode API の呼び出しで文字コード変換が必要な場合、無効なコードユニットは 'U+FFFD' REPLACEMENT CHARACTER（「The Unicode Standard - Core Specification」の第3.9章を参照）に置き換えられます。

機能テストマクロ	値	規格	機能
`__cpp_lib_print`	`202207L`	(C++23)	書式付き出力
`__cpp_lib_format`	`202207L`	(C++23)	std::basic_format_string の公開

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 4044	C++23	ネイティブ Unicode API は、常に、 os が参照する端末が Unicode を表示できる場合にのみ使用されていました。	端末が Unicode を表示できる場合、ネイティブ Unicode API のみが使用されていました。端末が Unicode を表示するためにネイティブ Unicode API のみを使用できる場合にのみ使用されます。

vprint_nonunicode(std::ostream) (C++23)	型消去された引数表現を使用して、文字データを出力する (function) [編集]
print(std::ostream) (C++23)	引数の書式化された表現を出力する (関数テンプレート) [編集]
operator<<(std::basic_ostream)	文字データを挿入する、または右辺値ストリームに挿入する (function template) [編集]
vprint_unicodevprint_unicode_buffered (C++23)	引数の型消去された表現を用いて、Unicode対応のstdoutまたはファイルストリームに出力する (関数) [編集]
format (C++20)	引数のフォーマット済み表現を新しい文字列に格納する (関数テンプレート) [編集]

1.	Unicode — Wikipedia
2.	The Unicode Standard Version 14.0 — Core Specification

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

目次