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

UnformattedInputFunction として動作します。 sentry オブジェクトの構築および確認の後、入力ストリームから次の文字を抽出せずに読み取ります。

引数

(なし)

戻り値

good() == true であれば、 rdbuf()->sgetc() によって取得された次の文字を返します。

そうでなければ、 Traits::eof() を返します。

例外

エラーが発生し (エラー状態フラグが goodbit でなく)、その状態に対して投げるために exceptions() がセットされている場合は failure。

内部の操作が例外を投げた場合、それはキャッチされ、 badbit がセットされます。 exceptions() が badbit に対してセットされていれば、その例外が投げ直されます。

例

#include <sstream>
#include <iostream>
int main()
{
    std::istringstream s1("Hello, world.");
    char c1 = s1.peek();
    char c2 = s1.get();
    std::cout << "Peeked: " << c1 << " got: " << c2 << '\n';
}

Peeked: H got: H

関連項目