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