std::strstreambuf::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::strstreambuf

公開成員函式

strstreambuf::strstreambuf

strstreambuf::~strstreambuf

strstreambuf::freeze

strstreambuf::str

strstreambuf::pcount

受保護的成員函式

strstreambuf::underflow

strstreambuf::pbackfail

strstreambuf::overflow

strstreambuf::setbuf

strstreambuf::seekoff

strstreambuf::seekpos

 

protected: virtual int_type pbackfail( int_type c = EOF );		(C++98 起棄用) (C++26 中移除)

此受保護的虛擬函式由公共函式 basic_streambuf::sungetc 和 basic_streambuf::sputbackc 呼叫（反過來，它們由 basic_istream::unget 和 basic_istream::putback 呼叫）。

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()，並將 c 寫入調整後 gptr() 指向的位置。

引數

c

-

要放回的字元，或 Traits::eof() 以指示請求將獲取區域向後移動

返回值

成功時返回 c，但如果 c 是 EOF，則返回除 EOF 之外的未指定值。

失敗時返回 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> 的公共成員函式)