std::basic_istream<CharT,Traits>:: ignore

从输入流中提取并丢弃字符，直至遇到并包括 delim 为止。

ignore 的行为类似于 无格式输入函数 。在构造并检查哨兵对象后，它会从流中提取字符并丢弃它们，直到满足以下任一条件：

• 提取了 count 个字符。当 count 等于 std:: numeric_limits < std:: streamsize > :: max ( ) 的特殊情况下，此测试将被禁用。

• 输入序列中出现文件结束条件，此时函数会调用 setstate ( eofbit ) 。

• 输入序列中的下一个可用字符 c 是 delim （由 Traits :: eq_int_type ( Traits :: to_int_type ( c ) , delim ) 确定）。该分隔符将被提取并丢弃。若 delim 为 Traits :: eof ( ) 则禁用此检测。

参数

返回值

* this

异常

如果内部操作抛出异常，该异常会被捕获并设置 badbit 。如果为 badbit 设置了 exceptions() ，则异常会被重新抛出。

示例

#include <iostream>
#include <limits>
#include <sstream>
constexpr auto max_size = std::numeric_limits<std::streamsize>::max();
int main()
{
    std::istringstream input("1\n"
                             "some non-numeric input\n"
                             "2\n");
    for (;;)
    {
        int n;
        input >> n;
        if (input.eof() || input.bad())
            break;
        else if (input.fail())
        {
            input.clear(); // unset failbit
            input.ignore(max_size, '\n'); // skip bad input
        }
        else
            std::cout << n << '\n';
    }
}

1
2

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

参见