C++ basic_ios Library - unget

---

---

Description

It is used to unget character.

Declaration

Following is the declaration for std::basic_istream::unget.

basic_istream& unget();

Parameters

none

Return Value

Returns the basic_istream object (*this).

Exceptions

Basic guarantee − if an exception is thrown, the object is in a valid state.

Data races

Modifies the stream object.

Example

In below example for std::basic_istream::unget.

#include <iostream>     
#include <string>       

int main () {
   std::cout << "Please, enter a number or a word: ";
   char c = std::cin.get();

   if ( (c >= '0') && (c <= '9') ) {
      int n;
      std::cin.unget();
      std::cin >> n;
      std::cout << "You entered a number: " << n << '\n';
   } else {
      std::string str;
      std::cin.unget();
      getline (std::cin,str);
      std::cout << "You entered a word: " << str << '\n';
   }
   return 0;
}

The output should be like this −

Please, enter a number or a word: 7791
You entered a number: 7791