std::basic_stringbuf<CharT,Traits,Allocator>::pbackfail
< cpp | io | basic stringbuf
| 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 无重读用的外部字符序列）
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() 。
示例
| 本节未完成 原因：暂无示例 |
参阅
| [虚] |
将字符放回输入序列，可能修改输入序列 ( std::basic_streambuf<CharT,Traits> 的虚受保护成员函数) |
| 回移一位输出序列中的下一位置指针 ( std::basic_streambuf<CharT,Traits> 的公开成员函数) | |
| 在输入序列中放回一个字符 ( std::basic_streambuf<CharT,Traits> 的公开成员函数) | |
| 撤销流中刚取走（移除，类似指针向后退回一个位置）的字符 ( std::basic_istream<CharT,Traits> 的公开成员函数) | |
| 往输入流中退回一个字符 ( std::basic_istream<CharT,Traits> 的公开成员函数) |