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

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

basic_istream& ignore( std::streamsize count, char_type delim );

ignore ведёт себя как функция неформатированного ввода. После создания и проверки объекта sentry функция извлекает символы из потока и отбрасывает их, пока не произойдёт одно из следующих условий:

• Извлечено 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

Исключения

failure, если произошла ошибка (флаг состояния ошибки не равен goodbit) и для этого состояния установлено, что exceptions() должен выбрасывать исключение.

Если внутренняя операция выбрасывает исключение, оно перехватывается, а 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++.

См. также