std::vprint_nonunicode, std::vprint_nonunicode_buffered

ヘッダ `<print>` で定義
void vprint_nonunicode( std::FILE* stream, std::string_view fmt, std::format_args args );	(1)	(C++23から)
void vprint_nonunicode_buffered ( std::FILE* stream, std::string_view fmt, std::format_args args );	(2)	(C++23から)
void vprint_nonunicode_buffered ( std::string_view fmt, std::format_args args );	(3)	(C++23から)

フォーマット文字列 fmt に従って引数 args をフォーマットし、その結果を出力ストリームに書き込みます。

1) stream のロックを保持しながら、fmt で指定されたフォーマット仕様に従ってフォーマットされた、args によって提供されるフォーマット引数の文字列表現を stream に書き込みます。

stream が有効な出力Cストリームへのポインタでない場合、動作は未定義です。

2) std::string out = std::vformat(fmt, args);
std::vprint_nonunicode(stream, "{}", std::make_format_args(out)); と同等です。

3) std::vprint_nonunicode_buffered(stdout, fmt, args) と同等です。

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

(C++26以降)

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 - フォーマットする引数

機能テストマクロ	値	規格	機能
`__cpp_lib_print`	`202207L`	(C++23)	書式付き出力
	`202403L`	(C++26) (DR23)	バッファなしのフォーマット済み出力
	`202406L`	(C++26) (DR23)	より多くのフォーマット可能な型でバッファなしのフォーマット済み出力を有効にする
`__cpp_lib_format`	`202207L`	(C++23)	std::basic_format_string の公開

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

DR	適用対象	公開された動作	正しい動作
P3107R5	C++23	印刷操作は常にバッファリングされていました	バッファリングされていない印刷操作を提供します
P3235R3	C++23	追加された関数の名前 P3107R5 によって誤解を招くものだった	関数名を変更した

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

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

出力関数
print (C++23)
println (C++23)
vprint_unicodevprint_unicode_buffered (C++23)(C++23)
vprint_nonunicodevprint_nonunicode_buffered (C++23)(C++23)

目次