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

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (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_istream

全局对象

cinwcin

成员函数

basic_istream::basic_istream

basic_istream::~basic_istream

basic_istream::operator= (C++11)

格式化输入

basic_istream::operator>>

非格式化输入

basic_istream::get

basic_istream::peek

basic_istream::unget

basic_istream::putback

basic_istream::getline

basic_istream::ignore

basic_istream::read

basic_istream::readsome

basic_istream::gcount

定位

basic_istream::tellg

basic_istream::seekg

其他

basic_istream::sync

basic_istream::swap (C++11)

成员类

basic_istream::sentry

非成员函数

operator>>(std::basic_istream)

 

basic_istream& ignore( std::streamsize count = 1, int_type delim = Traits::eof() );

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

ignore 的行为类似于 UnformattedInputFunction。在构造并检查哨兵对象后，它从流中提取字符并丢弃它们，直到以下任何条件发生

• 提取了 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()，则此测试将被禁用。

参数

count	-	要提取的字符数
delim	-	用于停止提取的定界符字符。它也会被提取

返回值

*this

异常

failure 如果发生错误（错误状态标志不是 goodbit）并且 exceptions() 设置为对该状态抛出异常。

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

示例

以下示例使用 ignore 跳过非数字输入

运行此代码

#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++ 标准。

DR	应用于	发布的行为	正确行为
LWG 172	C++98	count 的类型被错误地指定为 int	更正为 std::streamsize

参见

get	提取字符 (公共成员函数)
getline	提取字符，直到找到给定字符 (公共成员函数)