最終更新日時(UTC): 2026年02月20日 06時50分20秒
Akira Takahashi が更新

履歴 編集

function
<istream>

# std::basic_istream::peek

    int_type peek();

## 概要

（非書式化入力関数）ストリームバッファから次に入力される文字を先読みする。

すなわち、この関数は次に入力される文字を返すが、読み取り位置は変化しない。 この後の入力関数（書式化入力関数・非書式化入力関数いずれでも）で、改めて入力が行われる。

## 戻り値

- `good() == true`なら、`rdbuf()->sgetc()`。
- `good() == false`なら、`Traits::eof()`。

## 例

    #include <iostream>
    #include <locale>
    #include <string>

    bool try_read_int(std::istream& is, unsigned& x) {
      is >> std::ws;
      int n = is.peek();
      char c = std::char_traits<char>::to_char_type(n);
      if (std::isdigit(c, is.getloc())) {
        return is >> x
          ? true
          : false;
      } else {
        return false;
      }
    }

    int main() {
      // 0以上の整数を入力してください
      unsigned x;
      if (try_read_int(std::cin, x)) {
        std::cout << "入力された値: " << x << std::endl;
      } else {
        std::cout << "数値を入力してください。" << std::endl;
      }
    }

### 入力

    200

### 出力

    入力された値: 200

## 実装例

    int_type peek() {
      try {
        sentry s(*this, true);
        if (s) {
          return rdbuf()->sgetc();
        }
      } catch (...) {
        例外を投げずにbadbitを設定する;
        if ((exceptions() & badbit) != 0) {
          throw;
        }
      }
      return Traits::eof();
    }

## バージョン

### 言語

- C++98

## 参照

- `basic_istream::get`
- `basic_streambuf::sgetc`
- P1264R2 Revising the wording of stream input operations
  - C++23でローカルエラー状態の概念が導入され、入力関数のエラー処理セマンティクスが明確化された