std::basic_stringbuf<CharT,Traits,Allocator>::pbackfail

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

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>` 的公开成员函数)

公开成员函数
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