std::basic_streambuf<CharT,Traits>:: sungetc

如果获取区域中存在回退位置（ gptr ( ) > eback ( ) ），则递减下一个指针（ gptr() ）并返回其当前指向的字符。

如果放回位置不可用，则调用 pbackfail() 在可能的情况下回退输入序列。

I/O流函数 basic_istream::unget 是基于此函数实现的。

参数

(无)

返回值

如果回退位置可用，则返回下一个指针当前指向的字符，该字符已通过 Traits :: to_int_type ( * gptr ( ) ) 转换为 int_type 。此streambuf的下一次单字符输入将返回该字符。

如果回退位置不可用，则返回 pbackfail() 的返回值，失败时为 Traits :: eof ( ) 。

示例

#include <iostream>
#include <sstream>
int main()
{
    std::stringstream s("abcdef"); // gptr() 指向 'a'
    char c1 = s.get(); // c = 'a'，gptr() 现在指向 'b'
    char c2 = s.rdbuf()->sungetc(); // 等同于 s.unget()：gptr() 重新指向 'a'
    char c3 = s.get(); // c3 = 'a'，gptr() 现在指向 'b'
    char c4 = s.get(); // c4 = 'b'，gptr() 现在指向 'c'
    std::cout << c1 << c2 << c3 << c4 << '\n';
    s.rdbuf()->sungetc();  // 回退到 'b'
    s.rdbuf()->sungetc();  // 回退到 'a'
    int eof = s.rdbuf()->sungetc();  // 无字符可回退：pbackfail() 失败
    if (eof == EOF)
            std::cout << "Nothing to unget after 'a'\n";
}

aaab
Nothing to unget after 'a'

参见