5. unget

    • Class / Function / Type

      std::

    • Header file

      <>

    • Other / All

    crsearch v3.0.23

    最終更新日時(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

    参照