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

履歴 編集

function
<istream>

# std::basic_istream::unget

    basic_istream<CharT, Traits>& unget();

## 概要

（非書式化入力関数）最後に読み取った1文字をストリームバッファの入力に戻す。

非書式化入力関数であるが、初めに`eofbit`を消去する点が通常と異なる。

## 効果

1. `eofbit`を消去する。
2. `sentry`オブジェクトを構築する。
3. `!good()`ならローカルエラー状態に`failbit`を設定して終わる。
4. `rdbuf()->sungetc()`を呼び出す。
   - `rdbuf()`がヌルポインタであるか、`sungetc()`が`Traits::eof()`を返した場合、ローカルエラー状態に`badbit`を設定する。

## 戻り値

`*this`。

## 備考

この関数は1文字も入力を行わないため、この後の`gcount()`は`0`を返す。

## 例

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

    // isからアルファベットだけを読み込んで返す関数。
    std::string input_alphabet(std::istream& is) {
      std::string s;
      char c;
      while (is.get(c)) {
        // getで得た文字がアルファベットではなかったら、ungetでストリームに戻す。
        if (!std::isalpha(c, is.getloc())) {
          is.unget();
          break;
        }
        s.push_back(c);
      }
      return s;
    }

    int main() {
      std::istringstream iss("abc123");
      std::cout << input_alphabet(iss) << std::endl;

      // 残りを出力
      std::cout << iss.rdbuf() << std::endl;
    }

### 出力

    abc
    123

## 実装例

    basic_istream<CharT, Traits>& unget() {
      clear(rdstate() & ~eofbit);
      try {
        sentry s(*this, true);
        if (s) {
          if (auto sb = rdbuf()) {
            if (sb->sungetc() != Traits::eof()) {
              return *this;
            }
          }
          setstate(badbit);
        }
      } catch (...) {
        例外を投げずにbadbitを設定する;
        if ((exceptions() & badbit) != 0) {
          throw;
        }
      }
      return *this;
    }

## バージョン

### 言語

- C++98

## 参照

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