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

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().

Параметры

Возвращаемое значение

*this

Исключения

Если внутренняя операция вызывает исключение, оно перехватывается, и badbit устанавливается. Если exceptions() задано для badbit, исключение перебрасывается повторно.

Пример

#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++.

См. также