std::strstreambuf::pbackfail

protected: virtual int_type pbackfail( int_type c = EOF );		(C++98で非推奨) (C++26で削除)

このprotected virtual関数は、public関数であるbasic_streambuf::sungetc および basic_streambuf::sputbackc (これらはさらに basic_istream::unget および basic_istream::putback から呼び出されます) によって呼び出されます。

1) 呼び出し元が1文字だけ後退させることを要求している場合（`pbackfail()` が引数なしで、または `EOF` を引数として呼び出された場合）

a) まず、アンバック位置が存在するかどうかを確認し、存在しない場合は失敗します（`strstreambuf` は再読み込みできる外部文字ソースを持ちません）。

b) 呼び出し元が間違っており、実際にはアンバック位置が利用可能な場合、単に `basic_streambuf::gptr()` をデクリメントします。例えば、`gbump(-1)` を呼び出すことによって行われます。

2) コール元は、以前取得した文字とは異なる文字をアンバックしようとしています (pbackfail() がアンバックする必要のある文字を引数として呼び出された場合)。その場合、

a) まず、アンバック位置が存在するかどうかを確認し、存在しない場合は失敗します。

b) 次に、アンバック位置にある文字を確認します。その位置にある文字が既に `(char)c` と等しい場合、単に `basic_streambuf::gptr()` をデクリメントします。

c) それ以外の場合、バッファが変更不可能であれば（この `strstreambuf` が文字列リテラルまたはその他の `const` 配列で構築された場合）、失敗します。

d) それ以外の場合、`basic_streambuf::gptr()` をデクリメントし、調整後に `gptr()` が指す位置に `c` を書き込みます。

pbackfail [virtual]	入力シーケンスに1文字を戻す (入力シーケンスを変更する可能性あり) (`std::basic_streambuf<CharT,Traits>` の仮想 protected メンバ関数) [編集]
sungetc	入力シーケンスの次のポインタを1つ戻す (`std::basic_streambuf<CharT,Traits>` の public メンバ関数) [編集]
sputbackc	1文字を入力シーケンスに戻す (`std::basic_streambuf<CharT,Traits>` の public メンバ関数) [編集]
unget	文字を非抽出する (un-extract) (`std::basic_istream<CharT,Traits>` の public メンバ関数) [編集]
putback	文字を入力ストリームに戻す (`std::basic_istream<CharT,Traits>` の public メンバ関数) [編集]

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

目次