std:: vprint_nonunicode (std::ostream)

ヘッダーで定義 <ostream>
void vprint_nonunicode ( std:: ostream & os, std:: string_view fmt, std:: format_args args ) ;		(C++23以降)

FormattedOutputFunction として振る舞う（ただし、エラー報告の一部の詳細は 異なる ）。

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

1. まず、 sentry オブジェクトを構築してチェックします。
2. 次に、自動変数を以下のように初期化します： std:: string out = std:: vformat ( os. getloc ( ) , fmt, args ) ;
3. 最後に、文字シーケンス [ out. begin ( ) , out. end ( ) ) を os に挿入します。

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

(C++26以降)

目次 1 Parameters 2 Exceptions 3 Notes 4 Example 5 See also

パラメータ

os	-	データを挿入する出力ストリーム
fmt	-	フォーマット文字列を表すオブジェクト。フォーマット文字列は以下から構成される： 通常の文字（ { と } を除く）は変更されずに出力にコピーされる エスケープシーケンス { { と } } は、出力ではそれぞれ { と } に置き換えられる 置換フィールド 各置換フィールドは以下の形式を持つ： { arg-id (optional) } (1) { arg-id (optional) : format-spec } (2) 1) フォーマット指定なしの置換フィールド 2) フォーマット指定ありの置換フィールド arg-id - フォーマットに使用する args 内の引数のインデックスを指定する。省略された場合、引数は順番に使用される。 フォーマット文字列内の arg-id はすべて存在するか、すべて省略されなければならない。手動インデックスと自動インデックスの混合はエラーである。 format-spec - 対応する引数に対する std::formatter 特殊化によって定義されるフォーマット仕様。 } で始まることはできない。 基本型と標準文字列型の場合、フォーマット仕様は 標準フォーマット仕様 として解釈される。 chrono型の場合、フォーマット仕様は chronoフォーマット仕様 として解釈される。 範囲型の場合、フォーマット仕様は 範囲フォーマット仕様 として解釈される。 std::pair と std::tuple の場合、フォーマット仕様は タプルフォーマット仕様 として解釈される。 std::thread::id と std::stacktrace_entry の場合、 スレッドIDフォーマット仕様 と スタックトレースエントリフォーマット仕様 を参照。 std::basic_stacktrace の場合、フォーマット指定子は許可されない。 (C++23以降) std::filesystem::path の場合、 パスフォーマット仕様 を参照。 (C++26以降) その他のフォーマット可能な型の場合、フォーマット仕様はユーザー定義の formatter 特殊化によって決定される。
args	-	フォーマットする引数

例外

• std::bad_alloc がメモリ確保失敗時に送出される。
• 任意の フォーマッタ が送出する例外（例： std::format_error ）を、 os. exceptions ( ) の値に関わらず伝播し、 os のエラー状態における ios_base::badbit を設定しない。
• os への挿入が失敗した場合に呼び出される os. setstate ( ios_base :: badbit ) によって引き起こされる ios_base::failure を送出する可能性がある。

注記

機能テスト マクロ	値	標準	機能
__cpp_lib_print	202207L	(C++23)	フォーマット済み出力
__cpp_lib_format	202207L	(C++23)	std::basic_format_string の公開

例

このセクションは不完全です 理由: 例がありません

関連項目

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