std::operator>> (basic_istream)

(1) single character

Extracts the next character from is and stores it as the value of c.

(2) character sequence

Extracts characters from is and stores them in s as a c-string, stopping as soon as either a whitespace character is encountered or (width()-1) characters have been extracted (if width is not zero).
A null character (charT()) is automatically appended to the written sequence.
The function then resets width to zero.

(3) rvalue extraction

Allows extracting from rvalue basic_istream objects, with the same effect as from lvalues: It effectively calls: is>>val.

Parameters

is

Input stream object from which characters are extracted.

c

Object where the extracted character is stored.

s

Pointer to an array of characters where extracted characters are stored as a c-string.
is's member function width may be used to specify a limit on the number of characters to write.

val

Object where content is stored.
T shall be a type supported as right-hand side argument either by this function or by is's member function operator>>.

Return Value

Example

1
2
3
4
5
6
7
8
9
10
11
12
13

// example on extraction
#include <iostream>     // std::cin, std::cout
int main () {
  char str[10];
  std::cout << "Enter a word: ";
  std::cin.width (10);               // limit width
  std::cin >> str;
  std::cout << "The first 9 chars of your word are: " << str << '\n';
  return 0;
}

Data races

Exception safety

See also

basic_istream::get

Get characters (public member function)

basic_istream::getline

Get line (public member function)

basic_ostream::operator<<

Insert formatted output (public member function)

basic_istream::sentry

Prepare stream for input (public member class)