std::basic_stringbuf<CharT,Traits,Allocator>::view
From cppreference.com
< cpp | io | basic stringbuf
| std::basic_string_view<CharT, Traits> view() const noexcept; |
(C++20以降) | |
基になる文字シーケンスに対するstd::basic_string_viewを作成して返します。
- 入力専用ストリームの場合、返されるビューは範囲 [eback(), egptr()) を表します。
- 入出力ストリームまたは出力専用ストリームの場合、egptr() および epptr() にかかわらず、pbase() からシーケンスの最後の文字までの文字を参照します。
- ストリームが入出力のいずれでもない場合、 std::basic_string_view<CharT, Traits>{} を返します。
書き込み用に開かれているバッファのメンバ文字シーケンスは、効率のために過剰に割り当てられる可能性があります。この場合、参照されるのは*初期化された文字*のみです。これらの文字は、コンストラクタの文字列引数、str() のセッターオーバーロードの直近の呼び出しで使用された文字列引数、または書き込み操作から取得された文字です。過剰割り当てを使用する典型的な実装は、バッファの初期化部分の末尾を追跡するためにハイウォーターマークポインタを維持し、返されるビューは pbase() からハイウォーターマークポインタまでの文字を参照します。
目次 |
[編集] パラメータ
(なし)
[編集] 戻り値
基になる文字シーケンスに対するビュー。
[編集] 注
返されたビューは、基になる文字シーケンスが破棄または無効化された場合、返されたビューが空でない限り、未定義の動作となります。
この関数は通常、 std::basic_istringstream::view()、 std::basic_ostringstream::view()、または std::basic_stringstream::view() を介してアクセスされます。
[編集] 関連項目
| 関連する文字文字列のコピーを置き換える、または取得する (public member function) | |
| (C++17) |
文字列全体への変更不可能なbasic_string_viewを返します(public member function of std::basic_string<CharT,Traits,Allocator>) |
