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

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

輸入/輸出庫

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

受保護的成員函式

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() )

此受保護的虛擬函式由公共函式 basic_streambuf::sungetc 和 basic_streambuf::sputbackc 呼叫（後者又由 basic_istream::unget 和 basic_istream::putback 呼叫）。

1) 呼叫者請求將獲取區域向後回退一個字元（不帶引數呼叫 pbackfail()），在這種情況下，此函式重新讀取檔案，從前一個位元組開始，並遞減 basic_streambuf::gptr()，例如透過呼叫 gbump(-1)。

2) 呼叫方試圖放回與之前取得的字元不同的字元（以需要放回的字元為引數呼叫 pbackfail()），這種情況下

a) 首先，檢查是否存在回退位置，如果不存在，則透過重新讀取檔案並從前一個位元組開始，將獲取區域回退。

a) 然後檢查回退位置的字元。如果該字元已經等於 c，由 Traits::eq(to_char_type(c), gptr()[-1]) 確定，則簡單地遞減 basic_streambuf::gptr()。

b) 否則，如果允許緩衝區修改其自身的獲取區域，則遞減 basic_streambuf::gptr() 並將 c 寫入調整後 gptr() 指向的位置。

此函式從不修改檔案，只修改記憶體緩衝區的獲取區域。

如果檔案未開啟（is_open()==false），此函式立即返回 Traits::eof()。

引數

c

-

要回退的字元，或 Traits::eof() 以指示請求回退獲取區域

返回值

成功時返回 c，除非 c 是 Traits::eof()，在這種情況下返回 Traits::not_eof(c)。

失敗時返回 Traits::eof()。

參閱

pbackfail [虛]	將一個字元放回輸入序列，可能會修改輸入序列 （std::basic_streambuf<CharT,Traits> 的虛保護成員函式）
sungetc	將輸入序列中的下一個指標後退一個位置 （std::basic_streambuf<CharT,Traits> 的公共成員函式）
sputbackc	將一個字元放回輸入序列 （std::basic_streambuf<CharT,Traits> 的公共成員函式）
unget	取消提取字元 （std::basic_istream<CharT,Traits> 的公共成員函式）
putback	將字元放入輸入流 （std::basic_istream<CharT,Traits> 的公共成員函式）