std::vprint_nonunicode(std::ostream)
From cppreference.com
< cpp | io | basic_ostream
| ヘッダ <ostream>で定義 |
||
| void vprint_nonunicode( std::ostream& os, std::string_view fmt, std::format_args args ); |
(C++23から) | |
FormattedOutputFunction として動作します(ただし、エラー報告のいくつかの詳細については異なります)。
以下の操作を順番に実行します
- まず、sentry オブジェクトを構築してチェックします。
- 次に、自動変数 `std::std::string` `out` を、あたかも `out = std::std::vformat(os.getloc(), fmt, args)` で初期化されたかのように初期化します。
- 最後に、文字シーケンス `[` `out.begin()` `, ` `out.end()` `)` を `os` に挿入します。
|
`os` に文字を書き込んだ後、観測可能なチェックポイントを確立します。 |
(C++26以降) |
目次 |
[編集] パラメータ
| os | - | データを挿入する出力ストリーム | ||||||||||||||||||||||||||||||||||||||||||||||
| fmt | - |
各置換フィールドは以下の形式を持つ。
1) フォーマット指定なしの置換フィールド
2) フォーマット指定ありの置換フィールド
| ||||||||||||||||||||||||||||||||||||||||||||||
| args | - | フォーマットする引数 | ||||||||||||||||||||||||||||||||||||||||||||||
[編集] 例外
- アロケーションに失敗した場合、std::bad_alloc。
- os.exceptions() の値に関係なく、また os のエラー状態に ios_base::badbit を設定することなく、いずれかの formatter によってスローされた例外(例: std::format_error)を伝播します。
- 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 の公開 |
[編集] 例
| このセクションは未完成です 理由: 例がありません |
[編集] 関連項目
| (C++23) |
型消去された引数表現を使用して、Unicode対応の出力を行う (function) |
| (C++23) |
引数の書式化された表現を出力する (関数テンプレート) |
| 文字データを挿入する、または右辺値ストリームに挿入する (function template) | |
| 引数の型消去された表現を用いて、stdoutまたはファイルストリームに出力する (関数) | |
| (C++20) |
引数のフォーマット済み表現を新しい文字列に格納する (関数テンプレート) |