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

入力ストリームから文字を抽出して破棄し、 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++規格に対して遡及的に適用されました。

関連項目