std::basic_filebuf<CharT,Traits>::pbackfail

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

I/Oマニピュレータ

出力関数 (C++23)

C形式I/O

バッファ

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

ストリーム

抽象化

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイルI/O

basic_ifstream

basic_ofstream

basic_fstream

文字列I/O

basic_istringstream

basic_ostringstream

basic_stringstream

配列I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同期出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

エラーカテゴリインターフェース

iostream_category (C++11)

io_errc (C++11)

 

std::basic_filebuf

公開メンバ関数

basic_filebuf::basic_filebuf

basic_filebuf::~basic_filebuf

basic_filebuf::operator= (C++11)

basic_filebuf::swap (C++11)

basic_filebuf::native_handle (C++26)

basic_filebuf::is_open

basic_filebuf::open

basic_filebuf::close

Protected member functions

basic_filebuf::showmanyc

basic_filebuf::underflow

basic_filebuf::uflow

basic_filebuf::pbackfail

basic_filebuf::overflow

basic_filebuf::setbuf

basic_filebuf::seekoff

basic_filebuf::seekpos

basic_filebuf::sync

basic_filebuf::imbue

非メンバ関数

swap(std::basic_filebuf) (C++11)

 

protected: virtual int_type pbackfail( int_type c = Traits::eof() )

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

1) 呼び出し元が、読み取り領域（get area）を1文字分戻すことを要求している場合（pbackfail() が引数なしで呼び出された場合）、この関数は1バイト前の位置からファイルを再読み取りし、basic_streambuf::gptr() をデクリメントします。これは、たとえば gbump(-1) を呼び出すことによって行われます。

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

a) まず、プットバック位置（putback position）が存在するかどうかを確認します。存在しない場合は、ファイルを1バイト前の位置から再読み取りすることによって、読み取り領域を戻します。

a) 次に、プットバック位置にある文字を確認します。その文字が既に c と等しい場合（Traits::eq(to_char_type(c), gptr()[-1]) によって判断）、basic_streambuf::gptr() をデクリメントするだけです。

b) それ以外の場合、バッファが自身の読み取り領域を変更することが許可されていれば、basic_streambuf::gptr() をデクリメントし、調整後の gptr() が指す位置に c を書き込みます。

この関数はファイルを変更することはなく、インメモリバッファの読み取り領域のみを変更します。

ファイルが開かれていない場合（is_open()=false）、この関数は直ちに Traits::eof() を返します。

パラメータ

c

-

戻される文字、または読み取り領域のバックアップが要求されていることを示す Traits::eof()。

戻り値

成功した場合は c。ただし、c が Traits::eof() だった場合は、Traits::not_eof(c) が返されます。

失敗した場合は Traits::eof()。

関連項目

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 メンバ関数)