std::basic_stringbuf<CharT,Traits,Allocator>::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_stringbuf

公開成員函式

basic_stringbuf::basic_stringbuf

basic_stringbuf::operator= (C++11)

basic_stringbuf::swap (C++11)

basic_stringbuf::str

basic_stringbuf::get_allocator (C++20)

basic_stringbuf::view (C++20)

受保護的成員函式

basic_stringbuf::underflow

basic_stringbuf::pbackfail

basic_stringbuf::overflow

basic_stringbuf::setbuf

basic_stringbuf::seekoff

basic_stringbuf::seekpos

非成員函式

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

僅用於說明的成員函式

basic_stringbuf::init_buf_ptrs

 

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

此受保護虛擬函式為公開函式 basic_streambuf::sungetc 和 basic_streambuf::sputbackc 所呼叫（而它們又為 basic_istream::unget 和 basic_istream::putback 所呼叫）。

1) 呼叫方請求將獲取區回退一個字元（以無引數或以 Traits::eof() 為引數呼叫 pbackfail() ）

a) 首先，檢查是否有放回位置，而若確實沒有，則失敗。（ stringbuf 沒有外部字元源可供重讀）

b) 若呼叫方弄錯而放回位置實際上可用，則簡單地自減 basic_streambuf::gptr()，例如透過呼叫 gbump(-1)。

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

a) 首先，檢查是否有放回位置，而若沒有則失敗。

b) 然後檢查放回位置保有的是什麼字元。若該處保有的字元已經等於 c，由 Traits::eq(to_char_type(c), gptr()[-1]) 確定，則簡單地自減 basic_streambuf::gptr()。

c) 否則，若緩衝區僅為讀而開啟，則失敗。

d) 否則，若緩衝區為寫而開啟（mode && std::ios_base::out 非零），則自減 basic_streambuf::gptr() 並寫入 c 到 gptr() 調整後所指向的位置。

[編輯] 引數

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> 的公開成員函式)