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

 

C++

编译器支持

独立和宿主

语言

标准库

标准库头文件

具名要求

特性测试宏 (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) 调用者请求将读取区域后退一个字符 (pbackfail() 在没有参数或使用 Traits::eof() 作为参数的情况下被调用)

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