5. unget

最終更新日時(UTC):
が更新

履歴 編集

function
<istream>

std::basic_istream::unget

basic_istream<CharT, Traits>& unget();

概要

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

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

効果

  1. eofbitを消去する。
  2. sentryオブジェクトを構築する。
  3. !good()ならsetstate(failbit)して終わる。
  4. rdbuf()->sungetc()を呼び出す。
    • rdbuf()がヌルポインタであるか、sungetc()がTraits::eof()を返した場合、setstate(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

参照