class
<istream> <iostream>

std::istream

typedef basic_istream<char> istream;
Input stream

Input stream objects can read and interpret input from sequences of characters. Specific members are provided to perform these input operations (see functions below).

The standard object cin is an object of this type.

This is an instantiation of basic_istream with the following template parameters:
template parameterdefinitioncomments
charTcharAliased as member char_type
traitschar_traits<char>Aliased as member traits_type

Objects of these classes keep a set of internal fields inherited from ios_base and ios:
fieldmember functionsdescription
Formattingformat flagsflags
setf
unsetf
A set of internal flags that affect how certain input/output operations are interpreted or generated.
See member type fmtflags.
field widthwidthWidth of the next formatted element to insert.
display precisionprecisionDecimal precision for the next floating-point value inserted.
localegetloc
imbue
The locale object used by the function for formatted input/output operations affected by localization properties.
fill characterfillCharacter to pad a formatted field up to the field width (width).
Stateerror staterdstate
setstate
clear
The current error state of the stream.
Individual values may be obtained by calling good, eof, fail and bad.
See member type iostate.
exception maskexceptionsThe state flags for which a failure exception is thrown.
See member type iostate.
Othercallback stackregister_callbackStack of pointers to functions that are called when certain events occur.
extensible arraysiword
pword
xalloc
Internal arrays to store objects of type long and void*.
tied streamtiePointer to output stream that is flushed before each i/o operation on this stream.
stream bufferrdbufPointer to the associated streambuf object, which is charge of all input/output operations.

To these, istream adds the character count (accessible using member gcount).

Member types

The class contains the following member class:

Along with the following member types:
member typedefinition
char_typechar
traits_typechar_traits<char>
int_typeint
pos_typestreampos
off_typestreamoff
And these member types inherited from ios_base through ios:

Public member functions


Formatted input:

Unformatted input:

Positioning:

Synchronization:

Protected member functions


Public member functions inherited from ios


Public member functions inherited from ios_base

<istream>