Extracts and discards characters from the input stream until and includingdelim.

ignore behaves as anUnformattedInputFunction. After constructing and checking the sentry object, it extracts characters from the stream and discards them until any of the following conditions occurs:

• count characters were extracted. This test is disabled in the special case whencount equalsstd::numeric_limits<std::streamsize>::max().

• end of file conditions occurs in the input sequence, in which case the function callssetstate(eofbit).

• the next available characterc in the input sequence isdelim, as determined byTraits::eq_int_type(Traits::to_int_type(c), delim). The delimiter character is extracted and discarded. This test is disabled ifdelim isTraits::eof().

[edit]Parameters

[edit]Return value

*this

[edit]Exceptions

If an internal operation throws an exception, it is caught andbadbit is set. Ifexceptions() is set forbadbit, the exception is rethrown.

[edit]Example

#include <iostream>#include <limits>#include <sstream> constexprauto 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;elseif(input.fail()){            input.clear();// unset failbit            input.ignore(max_size,'\n');// skip bad input}elsestd::cout<< n<<'\n';}}

12

[edit]Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

[edit]See also

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Português
• Русский
• 中文