.TH "std::basic_istream< _CharT, _Traits >" 3cxx "libstdc++" \" -*- nroff -*-
.ad l
.nh
.SH NAME
std::basic_istream< _CharT, _Traits > \- Template class basic_istream\&.  

.SH SYNOPSIS
.br
.PP
.PP
\fC#include <istream>\fP
.PP
Inherits \fBstd::basic_ios< _CharT, _Traits >\fP\&.
.PP
Inherited by \fBstd::basic_iostream< char >\fP, \fBstd::basic_ifstream< _CharT, _Traits >\fP, \fBstd::basic_iostream< _CharT, _Traits >\fP, and \fBstd::basic_istringstream< _CharT, _Traits, _Alloc >\fP\&.
.SS "Classes"

.in +1c
.ti -1c
.RI "class \fBsentry\fP"
.br
.RI "Performs setup work for input streams\&. "
.in -1c
.SS "Public Types"

.in +1c
.ti -1c
.RI "\fBtypedef\fP \fBctype\fP< _CharT > \fB__ctype_type\fP"
.br
.ti -1c
.RI "\fBtypedef\fP \fBbasic_ios\fP< _CharT, _Traits > \fB__ios_type\fP"
.br
.ti -1c
.RI "\fBtypedef\fP \fBbasic_istream\fP< _CharT, _Traits > \fB__istream_type\fP"
.br
.ti -1c
.RI "\fBtypedef\fP \fBnum_get\fP< _CharT, \fBistreambuf_iterator\fP< _CharT, _Traits > > \fB__num_get_type\fP"
.br
.ti -1c
.RI "\fBtypedef\fP \fBbasic_streambuf\fP< _CharT, _Traits > \fB__streambuf_type\fP"
.br
.ti -1c
.RI "\fBtypedef\fP _CharT \fBchar_type\fP"
.br
.ti -1c
.RI "enum \fBevent\fP { \fBerase_event\fP, \fBimbue_event\fP, \fBcopyfmt_event\fP }"
.br
.RI "The set of events that may be passed to an event callback\&. "
.ti -1c
.RI "\fBtypedef\fP \fBvoid\fP(* \fBevent_callback\fP) (\fBevent\fP __e, \fBios_base\fP &__b, int __i)"
.br
.RI "The type of an event callback function\&. "
.ti -1c
.RI "\fBtypedef\fP _Ios_Fmtflags \fBfmtflags\fP"
.br
.RI "This is a bitmask type\&. "
.ti -1c
.RI "\fBtypedef\fP _Traits::int_type \fBint_type\fP"
.br
.ti -1c
.RI "\fBtypedef\fP _Ios_Iostate \fBiostate\fP"
.br
.RI "This is a bitmask type\&. "
.ti -1c
.RI "\fBtypedef\fP _Traits::off_type \fBoff_type\fP"
.br
.ti -1c
.RI "\fBtypedef\fP _Ios_Openmode \fBopenmode\fP"
.br
.RI "This is a bitmask type\&. "
.ti -1c
.RI "\fBtypedef\fP _Traits::pos_type \fBpos_type\fP"
.br
.ti -1c
.RI "\fBtypedef\fP _Ios_Seekdir \fBseekdir\fP"
.br
.RI "This is an enumerated type\&. "
.ti -1c
.RI "\fBtypedef\fP _Traits \fBtraits_type\fP"
.br
.in -1c
.PP
.RI "\fB\fP"
.br

.in +1c
.in +1c
.ti -1c
.RI "\fBtypedef\fP \fBnum_put\fP< _CharT, \fBostreambuf_iterator\fP< _CharT, _Traits > > \fB__num_put_type\fP"
.br
.in -1c
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBbasic_istream\fP (\fB__streambuf_type\fP *\fB__sb\fP)"
.br
.RI "Base constructor\&. "
.ti -1c
.RI "\fBvirtual\fP \fB~basic_istream\fP ()"
.br
.RI "Base destructor\&. "
.ti -1c
.RI "template<\fBtypename\fP _ValueT > \fBbasic_istream\fP< _CharT, _Traits > & \fB_M_extract\fP (_ValueT &\fB__v\fP)"
.br
.ti -1c
.RI "\fBconst\fP \fBlocale\fP & \fB_M_getloc\fP () \fBconst\fP"
.br
.RI "Locale access\&. "
.ti -1c
.RI "\fBvoid\fP \fB_M_setstate\fP (\fBiostate\fP \fB__state\fP)"
.br
.ti -1c
.RI "bool \fBbad\fP () \fBconst\fP"
.br
.RI "Fast error checking\&. "
.ti -1c
.RI "\fBvoid\fP \fBclear\fP (\fBiostate\fP \fB__state\fP=\fBgoodbit\fP)"
.br
.RI "[Re]sets the error state\&. "
.ti -1c
.RI "\fBbasic_ios\fP & \fBcopyfmt\fP (\fBconst\fP \fBbasic_ios\fP &\fB__rhs\fP)"
.br
.RI "Copies fields of __rhs into this\&. "
.ti -1c
.RI "bool \fBeof\fP () \fBconst\fP"
.br
.RI "Fast error checking\&. "
.ti -1c
.RI "\fBiostate\fP \fBexceptions\fP () \fBconst\fP"
.br
.RI "Throwing exceptions on errors\&. "
.ti -1c
.RI "\fBvoid\fP \fBexceptions\fP (\fBiostate\fP \fB__except\fP)"
.br
.RI "Throwing exceptions on errors\&. "
.ti -1c
.RI "bool \fBfail\fP () \fBconst\fP"
.br
.RI "Fast error checking\&. "
.ti -1c
.RI "char_type \fBfill\fP () \fBconst\fP"
.br
.RI "Retrieves the \fIempty\fP character\&. "
.ti -1c
.RI "char_type \fBfill\fP (char_type \fB__ch\fP)"
.br
.RI "Sets a new \fIempty\fP character\&. "
.ti -1c
.RI "\fBfmtflags\fP \fBflags\fP () \fBconst\fP"
.br
.RI "Access to format flags\&. "
.ti -1c
.RI "\fBfmtflags\fP \fBflags\fP (\fBfmtflags\fP \fB__fmtfl\fP)"
.br
.RI "Setting new format flags all at once\&. "
.ti -1c
.RI "\fBstreamsize\fP \fBgcount\fP () \fBconst\fP"
.br
.RI "Character counting\&. "
.ti -1c
.RI "\fBbasic_istream\fP< char > & \fBgetline\fP (char_type *\fB__s\fP, \fBstreamsize\fP __n, char_type \fB__delim\fP)"
.br
.RI "Explicit specialization declarations, defined in src/istream\&.cc\&. "
.ti -1c
.RI "\fBbasic_istream\fP< wchar_t > & \fBgetline\fP (char_type *\fB__s\fP, \fBstreamsize\fP __n, char_type \fB__delim\fP)"
.br
.ti -1c
.RI "\fBlocale\fP \fBgetloc\fP () \fBconst\fP"
.br
.RI "Locale access\&. "
.ti -1c
.RI "bool \fBgood\fP () \fBconst\fP"
.br
.RI "Fast error checking\&. "
.ti -1c
.RI "\fBbasic_istream\fP< char > & \fBignore\fP (\fBstreamsize\fP __n)"
.br
.ti -1c
.RI "\fBbasic_istream\fP< wchar_t > & \fBignore\fP (\fBstreamsize\fP __n)"
.br
.ti -1c
.RI "\fBbasic_istream\fP< char > & \fBignore\fP (\fBstreamsize\fP __n, int_type \fB__delim\fP)"
.br
.ti -1c
.RI "\fBbasic_istream\fP< wchar_t > & \fBignore\fP (\fBstreamsize\fP __n, int_type \fB__delim\fP)"
.br
.ti -1c
.RI "\fBlocale\fP \fBimbue\fP (\fBconst\fP \fBlocale\fP &\fB__loc\fP)"
.br
.RI "Moves to a new locale\&. "
.ti -1c
.RI "long & \fBiword\fP (int \fB__ix\fP)"
.br
.RI "Access to integer array\&. "
.ti -1c
.RI "char \fBnarrow\fP (char_type __c, char \fB__dfault\fP) \fBconst\fP"
.br
.RI "Squeezes characters\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (\fB__streambuf_type\fP *\fB__sb\fP)"
.br
.RI "Extracting into another streambuf\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (\fBvoid\fP *&__p)"
.br
.RI "Basic arithmetic extractors\&. "
.ti -1c
.RI "\fBstreamsize\fP \fBprecision\fP () \fBconst\fP"
.br
.RI "Flags access\&. "
.ti -1c
.RI "\fBstreamsize\fP \fBprecision\fP (\fBstreamsize\fP \fB__prec\fP)"
.br
.RI "Changing flags\&. "
.ti -1c
.RI "\fBvoid\fP *& \fBpword\fP (int \fB__ix\fP)"
.br
.RI "Access to void pointer array\&. "
.ti -1c
.RI "\fBbasic_streambuf\fP< _CharT, _Traits > * \fBrdbuf\fP () \fBconst\fP"
.br
.RI "Accessing the underlying buffer\&. "
.ti -1c
.RI "\fBbasic_streambuf\fP< _CharT, _Traits > * \fBrdbuf\fP (\fBbasic_streambuf\fP< _CharT, _Traits > *\fB__sb\fP)"
.br
.RI "Changing the underlying buffer\&. "
.ti -1c
.RI "\fBiostate\fP \fBrdstate\fP () \fBconst\fP"
.br
.RI "Returns the error state of the stream buffer\&. "
.ti -1c
.RI "\fBvoid\fP \fBregister_callback\fP (\fBevent_callback\fP \fB__fn\fP, int __index)"
.br
.RI "Add the callback __fn with parameter __index\&. "
.ti -1c
.RI "\fBfmtflags\fP \fBsetf\fP (\fBfmtflags\fP \fB__fmtfl\fP)"
.br
.RI "Setting new format flags\&. "
.ti -1c
.RI "\fBfmtflags\fP \fBsetf\fP (\fBfmtflags\fP \fB__fmtfl\fP, \fBfmtflags\fP __mask)"
.br
.RI "Setting new format flags\&. "
.ti -1c
.RI "\fBvoid\fP \fBsetstate\fP (\fBiostate\fP \fB__state\fP)"
.br
.RI "Sets additional flags in the error state\&. "
.ti -1c
.RI "\fBbasic_ostream\fP< _CharT, _Traits > * \fBtie\fP () \fBconst\fP"
.br
.RI "Fetches the current \fItied\fP stream\&. "
.ti -1c
.RI "\fBbasic_ostream\fP< _CharT, _Traits > * \fBtie\fP (\fBbasic_ostream\fP< _CharT, _Traits > *\fB__tiestr\fP)"
.br
.RI "Ties this stream to an output stream\&. "
.ti -1c
.RI "\fBvoid\fP \fBunsetf\fP (\fBfmtflags\fP __mask)"
.br
.RI "Clearing format flags\&. "
.ti -1c
.RI "char_type \fBwiden\fP (char __c) \fBconst\fP"
.br
.RI "Widens characters\&. "
.ti -1c
.RI "\fBstreamsize\fP \fBwidth\fP () \fBconst\fP"
.br
.RI "Flags access\&. "
.ti -1c
.RI "\fBstreamsize\fP \fBwidth\fP (\fBstreamsize\fP \fB__wide\fP)"
.br
.RI "Changing flags\&. "
.in -1c
.PP
.RI "\fB\fP"
.br

.in +1c
.in +1c
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (\fB__istream_type\fP &(*\fB__pf\fP)(\fB__istream_type\fP &))"
.br
.RI "Interface for manipulators\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (\fB__ios_type\fP &(*\fB__pf\fP)(\fB__ios_type\fP &))"
.br
.RI "Interface for manipulators\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (\fBios_base\fP &(*\fB__pf\fP)(\fBios_base\fP &))"
.br
.RI "Interface for manipulators\&. "
.in -1c
.in -1c
.PP
.RI "\fBExtractors\fP"
.br
All the \fCoperator>>\fP functions (aka \fIformatted input functions\fP) have some common behavior\&. Each starts by constructing a temporary object of type std::basic_istream::sentry with the second argument (noskipws) set to false\&. This has several effects, concluding with the setting of a status flag; see the sentry documentation for more\&.
.PP
If the sentry status is good, the function tries to extract whatever data is appropriate for the type of the argument\&.
.PP
If an exception is thrown during extraction, ios_base::badbit will be turned on in the stream's error state (without causing an ios_base::failure to be thrown) and the original exception will be rethrown if badbit is set in the exceptions mask\&. 
.PP
.in +1c
.in +1c
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (bool &__n)"
.br
.RI "Integer arithmetic extractors\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (short &__n)"
.br
.RI "Integer arithmetic extractors\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (unsigned short &__n)"
.br
.RI "Integer arithmetic extractors\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (int &__n)"
.br
.RI "Integer arithmetic extractors\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (unsigned int &__n)"
.br
.RI "Integer arithmetic extractors\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (long &__n)"
.br
.RI "Integer arithmetic extractors\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (unsigned long &__n)"
.br
.RI "Integer arithmetic extractors\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (long long &__n)"
.br
.RI "Integer arithmetic extractors\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (unsigned long long &__n)"
.br
.RI "Integer arithmetic extractors\&. "
.in -1c
.in -1c
.PP
.RI "\fB\fP"
.br

.in +1c
.in +1c
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (float &__f)"
.br
.RI "Floating point arithmetic extractors\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (double &__f)"
.br
.RI "Floating point arithmetic extractors\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (long double &__f)"
.br
.RI "Floating point arithmetic extractors\&. "
.in -1c
.in -1c
.PP
.RI "\fBUnformatted Input Functions\fP"
.br
All the unformatted input functions have some common behavior\&. Each starts by constructing a temporary object of type std::basic_istream::sentry with the second argument (noskipws) set to true\&. This has several effects, concluding with the setting of a status flag; see the sentry documentation for more\&.
.PP
If the sentry status is good, the function tries to extract whatever data is appropriate for the type of the argument\&.
.PP
The number of characters extracted is stored for later retrieval by gcount()\&.
.PP
If an exception is thrown during extraction, ios_base::badbit will be turned on in the stream's error state (without causing an ios_base::failure to be thrown) and the original exception will be rethrown if badbit is set in the exceptions mask\&. 
.PP
.in +1c
.in +1c
.ti -1c
.RI "int_type \fBget\fP ()"
.br
.RI "Simple extraction\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBget\fP (char_type &__c)"
.br
.RI "Simple extraction\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBget\fP (char_type *\fB__s\fP, \fBstreamsize\fP __n, char_type \fB__delim\fP)"
.br
.RI "Simple multiple-character extraction\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBget\fP (char_type *\fB__s\fP, \fBstreamsize\fP __n)"
.br
.RI "Simple multiple-character extraction\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBget\fP (\fB__streambuf_type\fP &\fB__sb\fP, char_type \fB__delim\fP)"
.br
.RI "Extraction into another streambuf\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBget\fP (\fB__streambuf_type\fP &\fB__sb\fP)"
.br
.RI "Extraction into another streambuf\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBgetline\fP (char_type *\fB__s\fP, \fBstreamsize\fP __n, char_type \fB__delim\fP)"
.br
.RI "String extraction\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBgetline\fP (char_type *\fB__s\fP, \fBstreamsize\fP __n)"
.br
.RI "String extraction\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBignore\fP (\fBstreamsize\fP __n, int_type \fB__delim\fP)"
.br
.RI "Discarding characters\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBignore\fP (\fBstreamsize\fP __n)"
.br
.RI "Simple extraction\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBignore\fP ()"
.br
.RI "Simple extraction\&. "
.ti -1c
.RI "int_type \fBpeek\fP ()"
.br
.RI "Looking ahead in the stream\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBread\fP (char_type *\fB__s\fP, \fBstreamsize\fP __n)"
.br
.RI "Extraction without delimiters\&. "
.ti -1c
.RI "\fBstreamsize\fP \fBreadsome\fP (char_type *\fB__s\fP, \fBstreamsize\fP __n)"
.br
.RI "Extraction until the buffer is exhausted, but no more\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBputback\fP (char_type __c)"
.br
.RI "Unextracting a single character\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBunget\fP ()"
.br
.RI "Unextracting the previous character\&. "
.ti -1c
.RI "int \fBsync\fP ()"
.br
.RI "Synchronizing the stream buffer\&. "
.ti -1c
.RI "pos_type \fBtellg\fP ()"
.br
.RI "Getting the current read position\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBseekg\fP (pos_type)"
.br
.RI "Changing the current read position\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBseekg\fP (off_type, \fBios_base::seekdir\fP)"
.br
.RI "Changing the current read position\&. "
.in -1c
.in -1c
.PP
.RI "\fB\fP"
.br

.in +1c
.in +1c
.ti -1c
.RI "\fBoperator bool\fP () \fBconst\fP"
.br
.RI "The quick-and-easy status check\&. "
.ti -1c
.RI "bool \fBoperator!\fP () \fBconst\fP"
.br
.RI "The quick-and-easy status check\&. "
.in -1c
.in -1c
.SS "Static Public Member Functions"

.in +1c
.ti -1c
.RI "\fBstatic\fP bool \fBsync_with_stdio\fP (bool \fB__sync\fP=\fBtrue\fP)"
.br
.RI "Interaction with the standard C I/O objects\&. "
.ti -1c
.RI "\fBstatic\fP int \fBxalloc\fP ()  \fBthrow\fP ()"
.br
.RI "Access to unique indices\&. "
.in -1c
.SS "Static Public Attributes"

.in +1c
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBadjustfield\fP"
.br
.RI "A mask of left|right|internal\&. Useful for the 2-arg form of \fCsetf\fP\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBopenmode\fP \fBapp\fP"
.br
.RI "Seek to end before each write\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBopenmode\fP \fBate\fP"
.br
.RI "Open and seek to end immediately after opening\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBiostate\fP \fBbadbit\fP"
.br
.RI "Indicates a loss of integrity in an input or output sequence (such as an irrecoverable read error from a file)\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBbasefield\fP"
.br
.RI "A mask of dec|oct|hex\&. Useful for the 2-arg form of \fCsetf\fP\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBseekdir\fP \fBbeg\fP"
.br
.RI "Request a seek relative to the beginning of the stream\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBopenmode\fP \fBbinary\fP"
.br
.RI "Perform input and output in binary mode (as opposed to text mode)\&. This is probably not what you think it is; see https://gcc.gnu.org/onlinedocs/libstdc++/manual/fstreams.html#std.io.filestreams.binary\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBboolalpha\fP"
.br
.RI "Insert/extract \fCbool\fP in alphabetic rather than numeric format\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBseekdir\fP \fBcur\fP"
.br
.RI "Request a seek relative to the current position within the sequence\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBdec\fP"
.br
.RI "Converts integer input or generates integer output in decimal base\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBseekdir\fP \fBend\fP"
.br
.RI "Request a seek relative to the current end of the sequence\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBiostate\fP \fBeofbit\fP"
.br
.RI "Indicates that an input operation reached the end of an input sequence\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBiostate\fP \fBfailbit\fP"
.br
.RI "Indicates that an input operation failed to read the expected characters, or that an output operation failed to generate the desired characters\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBfixed\fP"
.br
.RI "Generate floating-point output in fixed-point notation\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBfloatfield\fP"
.br
.RI "A mask of scientific|fixed\&. Useful for the 2-arg form of \fCsetf\fP\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBiostate\fP \fBgoodbit\fP"
.br
.RI "Indicates all is well\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBhex\fP"
.br
.RI "Converts integer input or generates integer output in hexadecimal base\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBopenmode\fP \fBin\fP"
.br
.RI "Open for input\&. Default for \fCifstream\fP and fstream\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBinternal\fP"
.br
.RI "Adds fill characters at a designated internal point in certain generated output, or identical to \fCright\fP if no such point is designated\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBleft\fP"
.br
.RI "Adds fill characters on the right (final positions) of certain generated output\&. (I\&.e\&., the thing you print is flush left\&.) "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBoct\fP"
.br
.RI "Converts integer input or generates integer output in octal base\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBopenmode\fP \fBout\fP"
.br
.RI "Open for output\&. Default for \fCofstream\fP and fstream\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBright\fP"
.br
.RI "Adds fill characters on the left (initial positions) of certain generated output\&. (I\&.e\&., the thing you print is flush right\&.) "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBscientific\fP"
.br
.RI "Generates floating-point output in scientific notation\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBshowbase\fP"
.br
.RI "Generates a prefix indicating the numeric base of generated integer output\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBshowpoint\fP"
.br
.RI "Generates a decimal-point character unconditionally in generated floating-point output\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBshowpos\fP"
.br
.RI "Generates a + sign in non-negative generated numeric output\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBskipws\fP"
.br
.RI "Skips leading white space before certain input operations\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBopenmode\fP \fBtrunc\fP"
.br
.RI "Truncate an existing stream when opening\&. Default for \fCofstream\fP\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBunitbuf\fP"
.br
.RI "Flushes output after each output operation\&. "
.ti -1c
.RI "\fBstatic\fP \fBconst\fP \fBfmtflags\fP \fBuppercase\fP"
.br
.RI "Replaces certain lowercase letters with their uppercase equivalents in generated output\&. "
.in -1c
.SS "Protected Types"

.in +1c
.ti -1c
.RI "enum { \fB_S_local_word_size\fP }"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "\fBbasic_istream\fP (\fBbasic_istream\fP &&\fB__rhs\fP)"
.br
.ti -1c
.RI "\fBbasic_istream\fP (\fBconst\fP \fBbasic_istream\fP &)=\fBdelete\fP"
.br
.ti -1c
.RI "\fBvoid\fP \fB_M_cache_locale\fP (\fBconst\fP \fBlocale\fP &\fB__loc\fP)"
.br
.ti -1c
.RI "\fBvoid\fP \fB_M_call_callbacks\fP (\fBevent\fP \fB__ev\fP)  \fBthrow\fP ()"
.br
.ti -1c
.RI "\fBvoid\fP \fB_M_dispose_callbacks\fP (\fBvoid\fP)  \fBthrow\fP ()"
.br
.ti -1c
.RI "template<\fBtypename\fP _ValueT > \fB__istream_type\fP & \fB_M_extract\fP (_ValueT &\fB__v\fP)"
.br
.ti -1c
.RI "_Words & \fB_M_grow_words\fP (int __index, bool \fB__iword\fP)"
.br
.ti -1c
.RI "\fBvoid\fP \fB_M_init\fP ()  \fBthrow\fP ()"
.br
.ti -1c
.RI "\fBvoid\fP \fB_M_move\fP (\fBios_base\fP &) \fBnoexcept\fP"
.br
.ti -1c
.RI "\fBvoid\fP \fB_M_swap\fP (\fBios_base\fP &\fB__rhs\fP) \fBnoexcept\fP"
.br
.ti -1c
.RI "\fBvoid\fP \fBinit\fP (\fBbasic_streambuf\fP< _CharT, _Traits > *\fB__sb\fP)"
.br
.RI "All setup is performed here\&. "
.ti -1c
.RI "\fBvoid\fP \fBmove\fP (\fBbasic_ios\fP &&\fB__rhs\fP)"
.br
.ti -1c
.RI "\fBvoid\fP \fBmove\fP (\fBbasic_ios\fP &\fB__rhs\fP)"
.br
.ti -1c
.RI "\fBbasic_istream\fP & \fBoperator=\fP (\fBbasic_istream\fP &&\fB__rhs\fP)"
.br
.ti -1c
.RI "\fBbasic_istream\fP & \fBoperator=\fP (\fBconst\fP \fBbasic_istream\fP &)=\fBdelete\fP"
.br
.ti -1c
.RI "\fBvoid\fP \fBset_rdbuf\fP (\fBbasic_streambuf\fP< _CharT, _Traits > *\fB__sb\fP)"
.br
.ti -1c
.RI "\fBvoid\fP \fBswap\fP (\fBbasic_ios\fP &\fB__rhs\fP) \fBnoexcept\fP"
.br
.ti -1c
.RI "\fBvoid\fP \fBswap\fP (\fBbasic_istream\fP &\fB__rhs\fP)"
.br
.in -1c
.SS "Protected Attributes"

.in +1c
.ti -1c
.RI "_Callback_list * \fB_M_callbacks\fP"
.br
.ti -1c
.RI "\fBconst\fP \fB__ctype_type\fP * \fB_M_ctype\fP"
.br
.ti -1c
.RI "\fBiostate\fP \fB_M_exception\fP"
.br
.ti -1c
.RI "char_type \fB_M_fill\fP"
.br
.ti -1c
.RI "bool \fB_M_fill_init\fP"
.br
.ti -1c
.RI "\fBfmtflags\fP \fB_M_flags\fP"
.br
.ti -1c
.RI "\fBstreamsize\fP \fB_M_gcount\fP"
.br
.ti -1c
.RI "\fBlocale\fP \fB_M_ios_locale\fP"
.br
.ti -1c
.RI "_Words \fB_M_local_word\fP [_S_local_word_size]"
.br
.ti -1c
.RI "\fBconst\fP \fB__num_get_type\fP * \fB_M_num_get\fP"
.br
.ti -1c
.RI "\fBconst\fP \fB__num_put_type\fP * \fB_M_num_put\fP"
.br
.ti -1c
.RI "\fBstreamsize\fP \fB_M_precision\fP"
.br
.ti -1c
.RI "\fBbasic_streambuf\fP< _CharT, _Traits > * \fB_M_streambuf\fP"
.br
.ti -1c
.RI "\fBiostate\fP \fB_M_streambuf_state\fP"
.br
.ti -1c
.RI "\fBbasic_ostream\fP< _CharT, _Traits > * \fB_M_tie\fP"
.br
.ti -1c
.RI "\fBstreamsize\fP \fB_M_width\fP"
.br
.ti -1c
.RI "_Words * \fB_M_word\fP"
.br
.ti -1c
.RI "int \fB_M_word_size\fP"
.br
.ti -1c
.RI "_Words \fB_M_word_zero\fP"
.br
.in -1c
.SS "Friends"

.in +1c
.ti -1c
.RI "\fBclass\fP \fBsentry\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 

.SS "template<\fBtypename\fP _CharT, \fBtypename\fP _Traits>
.br
class std::basic_istream< _CharT, _Traits >"Template class basic_istream\&. 


.PP
\fBTemplate Parameters\fP
.RS 4
\fI_CharT\fP Type of character stream\&. 
.br
\fI_Traits\fP Traits for character type, defaults to char_traits<_CharT>\&.
.RE
.PP
This is the base class for all input streams\&. It provides text formatting of all builtin types, and communicates with any class derived from basic_streambuf to do the actual input\&. 
.SH "Member Typedef Documentation"
.PP 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBtypedef\fP \fBnum_put\fP<_CharT, \fBostreambuf_iterator\fP<_CharT, _Traits> > \fBstd::basic_ios\fP< _CharT, _Traits >::__num_put_type\fC [inherited]\fP"
These are non-standard types\&. 
.SS "\fBtypedef\fP \fBvoid\fP(* std::ios_base::event_callback) (\fBevent\fP __e, \fBios_base\fP &__b, int __i)\fC [inherited]\fP"

.PP
The type of an event callback function\&. 
.PP
\fBParameters\fP
.RS 4
\fI__e\fP One of the members of the event enum\&. 
.br
\fI__b\fP Reference to the ios_base object\&. 
.br
\fI__i\fP The integer provided when the callback was registered\&.
.RE
.PP
Event callbacks are user defined functions that get called during several ios_base and basic_ios functions, specifically imbue(), copyfmt(), and ~ios()\&. 
.SS "\fBtypedef\fP _Ios_Fmtflags std::ios_base::fmtflags\fC [inherited]\fP"

.PP
This is a bitmask type\&. \fC\fI_Ios_Fmtflags\fP is\fP implementation-defined, but it is valid to perform bitwise operations on these values and expect the Right Thing to happen\&. Defined objects of type fmtflags are:
.IP "\(bu" 2
boolalpha
.IP "\(bu" 2
dec
.IP "\(bu" 2
fixed
.IP "\(bu" 2
hex
.IP "\(bu" 2
internal
.IP "\(bu" 2
left
.IP "\(bu" 2
oct
.IP "\(bu" 2
right
.IP "\(bu" 2
scientific
.IP "\(bu" 2
showbase
.IP "\(bu" 2
showpoint
.IP "\(bu" 2
showpos
.IP "\(bu" 2
skipws
.IP "\(bu" 2
unitbuf
.IP "\(bu" 2
uppercase
.IP "\(bu" 2
adjustfield
.IP "\(bu" 2
basefield
.IP "\(bu" 2
floatfield 
.PP

.SS "\fBtypedef\fP _Ios_Iostate std::ios_base::iostate\fC [inherited]\fP"

.PP
This is a bitmask type\&. \fC\fI_Ios_Iostate\fP is\fP implementation-defined, but it is valid to perform bitwise operations on these values and expect the Right Thing to happen\&. Defined objects of type iostate are:
.IP "\(bu" 2
badbit
.IP "\(bu" 2
eofbit
.IP "\(bu" 2
failbit
.IP "\(bu" 2
goodbit 
.PP

.SS "\fBtypedef\fP _Ios_Openmode std::ios_base::openmode\fC [inherited]\fP"

.PP
This is a bitmask type\&. \fC\fI_Ios_Openmode\fP is\fP implementation-defined, but it is valid to perform bitwise operations on these values and expect the Right Thing to happen\&. Defined objects of type openmode are:
.IP "\(bu" 2
app
.IP "\(bu" 2
ate
.IP "\(bu" 2
binary
.IP "\(bu" 2
in
.IP "\(bu" 2
out
.IP "\(bu" 2
trunc 
.PP

.SS "\fBtypedef\fP _Ios_Seekdir std::ios_base::seekdir\fC [inherited]\fP"

.PP
This is an enumerated type\&. \fC\fI_Ios_Seekdir\fP is\fP implementation-defined\&. Defined values of type seekdir are:
.IP "\(bu" 2
beg
.IP "\(bu" 2
cur, equivalent to \fCSEEK_CUR\fP in the C standard library\&.
.IP "\(bu" 2
end, equivalent to \fCSEEK_END\fP in the C standard library\&. 
.PP

.SH "Member Enumeration Documentation"
.PP 
.SS "\fBenum\fP \fBstd::ios_base::event\fP\fC [inherited]\fP"

.PP
The set of events that may be passed to an event callback\&. erase_event is used during ~ios() and copyfmt()\&. imbue_event is used during imbue()\&. copyfmt_event is used during copyfmt()\&. 
.SH "Constructor & Destructor Documentation"
.PP 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBstd::basic_istream\fP< _CharT, _Traits >::basic_istream (\fB__streambuf_type\fP * __sb)\fC [inline]\fP, \fC [explicit]\fP"

.PP
Base constructor\&. This ctor is almost never called by the user directly, rather from derived classes' initialization lists, which pass a pointer to their own stream buffer\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBvirtual\fP \fBstd::basic_istream\fP< _CharT, _Traits >::~\fBbasic_istream\fP ()\fC [inline]\fP, \fC [virtual]\fP"

.PP
Base destructor\&. This does very little apart from providing a virtual base dtor\&. 
.SH "Member Function Documentation"
.PP 
.SS "\fBconst\fP \fBlocale\fP & std::ios_base::_M_getloc () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Locale access\&. 
.PP
\fBReturns\fP
.RS 4
A reference to the current locale\&.
.RE
.PP
Like getloc above, but returns a reference instead of generating a copy\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > bool \fBstd::basic_ios\fP< _CharT, _Traits >::bad () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Fast error checking\&. 
.PP
\fBReturns\fP
.RS 4
True if the badbit is set\&.
.RE
.PP
Note that other iostate flags may also be set\&. 
.PP
References \fBstd::ios_base::badbit\fP, and \fBstd::basic_ios< _CharT, _Traits >::rdstate()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBvoid\fP \fBstd::basic_ios\fP< _CharT, _Traits >::clear (\fBiostate\fP __state = \fC\fBgoodbit\fP\fP)\fC [inherited]\fP"

.PP
[Re]sets the error state\&. 
.PP
\fBParameters\fP
.RS 4
\fI__state\fP The new state flag(s) to set\&.
.RE
.PP
See std::ios_base::iostate for the possible bit values\&. Most users will not need to pass an argument\&. 
.PP
Referenced by \fBstd::basic_ios< _CharT, _Traits >::exceptions()\fP, \fBstd::basic_istream< _CharT, _Traits >::putback()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP, and \fBstd::basic_istream< _CharT, _Traits >::unget()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_ios\fP< _CharT, _Traits > & \fBstd::basic_ios\fP< _CharT, _Traits >::copyfmt (\fBconst\fP \fBbasic_ios\fP< _CharT, _Traits > & __rhs)\fC [inherited]\fP"

.PP
Copies fields of __rhs into this\&. 
.PP
\fBParameters\fP
.RS 4
\fI__rhs\fP The source values for the copies\&. 
.RE
.PP
\fBReturns\fP
.RS 4
Reference to this object\&.
.RE
.PP
All fields of __rhs are copied into this object except that rdbuf() and rdstate() remain unchanged\&. All values in the pword and iword arrays are copied\&. Before copying, each callback is invoked with erase_event\&. After copying, each (new) callback is invoked with copyfmt_event\&. The final step is to copy exceptions()\&. 
.PP
References \fBstd::basic_ios< _CharT, _Traits >::tie()\fP, and \fBstd::tie()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > bool \fBstd::basic_ios\fP< _CharT, _Traits >::eof () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Fast error checking\&. 
.PP
\fBReturns\fP
.RS 4
True if the eofbit is set\&.
.RE
.PP
Note that other iostate flags may also be set\&. 
.PP
References \fBstd::ios_base::eofbit\fP, and \fBstd::basic_ios< _CharT, _Traits >::rdstate()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBiostate\fP \fBstd::basic_ios\fP< _CharT, _Traits >::exceptions () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Throwing exceptions on errors\&. 
.PP
\fBReturns\fP
.RS 4
The current exceptions mask\&.
.RE
.PP
This changes nothing in the stream\&. See the one-argument version of exceptions(iostate) for the meaning of the return value\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBvoid\fP \fBstd::basic_ios\fP< _CharT, _Traits >::exceptions (\fBiostate\fP __except)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Throwing exceptions on errors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__except\fP The new exceptions mask\&.
.RE
.PP
By default, error flags are set silently\&. You can set an exceptions mask for each stream; if a bit in the mask becomes set in the error flags, then an exception of type std::ios_base::failure is thrown\&.
.PP
If the error flag is already set when the exceptions mask is added, the exception is immediately thrown\&. Try running the following under GCC 3\&.1 or later: 
.PP
.nf
#include <iostream>
#include <fstream>
#include <exception>

int main()
{
    std::set_terminate (__gnu_cxx::__verbose_terminate_handler);

    std::ifstream f ("/etc/motd");

    std::cerr << "Setting badbit\\n";
    f\&.setstate (std::ios_base::badbit);

    std::cerr << "Setting exception mask\\n";
    f\&.exceptions (std::ios_base::badbit);
}

.fi
.PP
 
.PP
References \fBstd::basic_ios< _CharT, _Traits >::clear()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > bool \fBstd::basic_ios\fP< _CharT, _Traits >::fail () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Fast error checking\&. 
.PP
\fBReturns\fP
.RS 4
True if either the badbit or the failbit is set\&.
.RE
.PP
Checking the badbit in fail() is historical practice\&. Note that other iostate flags may also be set\&. 
.PP
References \fBstd::ios_base::badbit\fP, \fBstd::ios_base::failbit\fP, and \fBstd::basic_ios< _CharT, _Traits >::rdstate()\fP\&.
.PP
Referenced by \fBstd::basic_ios< _CharT, _Traits >::operator bool()\fP, \fBstd::basic_ios< _CharT, _Traits >::operator!()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_istream< _CharT, _Traits >::tellg()\fP, and \fBstd::basic_ostream< _CharT, _Traits >::tellp()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > char_type \fBstd::basic_ios\fP< _CharT, _Traits >::fill () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Retrieves the \fIempty\fP character\&. 
.PP
\fBReturns\fP
.RS 4
The current fill character\&.
.RE
.PP
It defaults to a space (' ') in the current locale\&. 
.PP
References \fBstd::basic_ios< _CharT, _Traits >::widen()\fP\&.
.PP
Referenced by \fBstd::basic_ios< _CharT, _Traits >::fill()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > char_type \fBstd::basic_ios\fP< _CharT, _Traits >::fill (\fBchar_type\fP __ch)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Sets a new \fIempty\fP character\&. 
.PP
\fBParameters\fP
.RS 4
\fI__ch\fP The new character\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The previous fill character\&.
.RE
.PP
The fill character is used to fill out space when P+ characters have been requested (e\&.g\&., via setw), Q characters are actually used, and Q<P\&. It defaults to a space (' ') in the current locale\&. 
.PP
References \fBstd::basic_ios< _CharT, _Traits >::fill()\fP\&.
.SS "\fBfmtflags\fP std::ios_base::flags () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Access to format flags\&. 
.PP
\fBReturns\fP
.RS 4
The format control flags for both input and output\&. 
.RE
.PP

.SS "\fBfmtflags\fP std::ios_base::flags (\fBfmtflags\fP __fmtfl)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Setting new format flags all at once\&. 
.PP
\fBParameters\fP
.RS 4
\fI__fmtfl\fP The new flags to set\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The previous format control flags\&.
.RE
.PP
This function overwrites all the format flags with \fI__fmtfl\fP\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBstreamsize\fP \fBstd::basic_istream\fP< _CharT, _Traits >::gcount () const\fC [inline]\fP"

.PP
Character counting\&. 
.PP
\fBReturns\fP
.RS 4
The number of characters extracted by the previous unformatted input function dispatched for this stream\&. 
.RE
.PP

.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits >::int_type \fBstd::basic_istream\fP< _CharT, _Traits >::get (\fBvoid\fP)"

.PP
Simple extraction\&. 
.PP
\fBReturns\fP
.RS 4
A character, or eof()\&.
.RE
.PP
Tries to extract a character\&. If none are available, sets failbit and returns traits::eof()\&. 
.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::get (\fB__streambuf_type\fP & __sb)\fC [inline]\fP"

.PP
Extraction into another streambuf\&. 
.PP
\fBParameters\fP
.RS 4
\fI__sb\fP A streambuf in which to store data\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
Returns \fCget\fP(__sb,widen('\\n'))\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::get (\fB__streambuf_type\fP & __sb, char_type __delim)"

.PP
Extraction into another streambuf\&. 
.PP
\fBParameters\fP
.RS 4
\fI__sb\fP A streambuf in which to store data\&. 
.br
\fI__delim\fP A 'stop' character\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
Characters are extracted and inserted into \fI__sb\fP until one of the following happens:
.PP
.IP "\(bu" 2
the input sequence reaches EOF
.IP "\(bu" 2
insertion into the output buffer fails (in this case, the character that would have been inserted is not extracted)
.IP "\(bu" 2
the next character equals \fI__delim\fP (in this case, the character is not extracted)
.IP "\(bu" 2
an exception occurs (and in this case is caught)
.PP
.PP
If no characters are stored, failbit is set in the stream's error state\&. 
.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::get (char_type & __c)"

.PP
Simple extraction\&. 
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The character in which to store data\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
Tries to extract a character and store it in \fI__c\fP\&. If none are available, sets failbit and returns traits::eof()\&.
.PP
\fBNote\fP
.RS 4
This function is not overloaded on signed char and unsigned char\&. 
.RE
.PP

.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP, \fBstd::ios_base::badbit\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::get (char_type * __s, \fBstreamsize\fP __n)\fC [inline]\fP"

.PP
Simple multiple-character extraction\&. 
.PP
\fBParameters\fP
.RS 4
\fI__s\fP Pointer to an array\&. 
.br
\fI__n\fP Maximum number of characters to store in \fIs\fP\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
Returns \fCget\fP(__s,__n,widen('\\n'))\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::get (char_type * __s, \fBstreamsize\fP __n, char_type __delim)"

.PP
Simple multiple-character extraction\&. 
.PP
\fBParameters\fP
.RS 4
\fI__s\fP Pointer to an array\&. 
.br
\fI__n\fP Maximum number of characters to store in \fI__s\fP\&. 
.br
\fI__delim\fP A 'stop' character\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
Characters are extracted and stored into \fI__s\fP until one of the following happens:
.PP
.IP "\(bu" 2
\fC__n-1\fP characters are stored
.IP "\(bu" 2
the input sequence reaches EOF
.IP "\(bu" 2
the next character equals \fI__delim\fP, in which case the character is not extracted
.PP
.PP
If no characters are stored, failbit is set in the stream's error state\&.
.PP
In any case, a null character is stored into the next location in the array\&.
.PP
\fBNote\fP
.RS 4
This function is not overloaded on signed char and unsigned char\&. 
.RE
.PP

.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::getline (char_type * __s, \fBstreamsize\fP __n)\fC [inline]\fP"

.PP
String extraction\&. 
.PP
\fBParameters\fP
.RS 4
\fI__s\fP A character array in which to store the data\&. 
.br
\fI__n\fP Maximum number of characters to extract\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
Returns \fCgetline\fP(__s,__n,widen('\\n'))\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::getline (char_type * __s, \fBstreamsize\fP __n, char_type __delim)"

.PP
String extraction\&. 
.PP
\fBParameters\fP
.RS 4
\fI__s\fP A character array in which to store the data\&. 
.br
\fI__n\fP Maximum number of characters to extract\&. 
.br
\fI__delim\fP A 'stop' character\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
Extracts and stores characters into \fI__s\fP until one of the following happens\&. Note that these criteria are required to be tested in the order listed here, to allow an input line to exactly fill the \fI__s\fP array without setting failbit\&.
.PP
.IP "1." 4
the input sequence reaches end-of-file, in which case eofbit is set in the stream error state
.IP "2." 4
the next character equals \fC__delim\fP, in which case the character is extracted (and therefore counted in \fCgcount()\fP) but not stored
.IP "3." 4
\fC__n-1\fP characters are stored, in which case failbit is set in the stream error state
.PP
.PP
If no characters are extracted, failbit is set\&. (An empty line of input should therefore not cause failbit to be set\&.)
.PP
In any case, a null character is stored in the next location in the array\&. 
.SS "\fBbasic_istream\fP< char > & \fBstd::basic_istream\fP< char >::getline (char_type * __s, \fBstreamsize\fP __n, char_type __delim)"

.PP
Explicit specialization declarations, defined in src/istream\&.cc\&. 
.SS "\fBlocale\fP std::ios_base::getloc () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Locale access\&. 
.PP
\fBReturns\fP
.RS 4
A copy of the current locale\&.
.RE
.PP
If \fCimbue(loc)\fP has previously been called, then this function returns \fCloc\fP\&. Otherwise, it returns a copy of \fCstd::locale()\fP, the global C++ locale\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > bool \fBstd::basic_ios\fP< _CharT, _Traits >::good () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Fast error checking\&. 
.PP
\fBReturns\fP
.RS 4
True if no error flags are set\&.
.RE
.PP
A wrapper around rdstate\&. 
.PP
References \fBstd::basic_ios< _CharT, _Traits >::rdstate()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::ignore (\fBvoid\fP)"

.PP
Simple extraction\&. 
.PP
\fBReturns\fP
.RS 4
A character, or eof()\&.
.RE
.PP
Tries to extract a character\&. If none are available, sets failbit and returns traits::eof()\&. 
.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::ignore (\fBstreamsize\fP __n)"

.PP
Simple extraction\&. 
.PP
\fBReturns\fP
.RS 4
A character, or eof()\&.
.RE
.PP
Tries to extract a character\&. If none are available, sets failbit and returns traits::eof()\&. 
.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::ignore (\fBstreamsize\fP __n, int_type __delim)"

.PP
Discarding characters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP Number of characters to discard\&. 
.br
\fI__delim\fP A 'stop' character\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
Extracts characters and throws them away until one of the following happens:
.IP "\(bu" 2
if \fI__n\fP \fC!=\fP \fCstd::numeric_limits<int>::max()\fP, \fI__n\fP characters are extracted
.IP "\(bu" 2
the input sequence reaches end-of-file
.IP "\(bu" 2
the next character equals \fI__delim\fP (in this case, the character is extracted); note that this condition will never occur if \fI__delim\fP equals \fCtraits::eof()\fP\&.
.PP
.PP
NB: Provide three overloads, instead of the single function (with defaults) mandated by the Standard: this leads to a better performing implementation, while still conforming to the Standard\&. 
.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP, and \fBstd::ios_base::goodbit\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBlocale\fP \fBstd::basic_ios\fP< _CharT, _Traits >::imbue (\fBconst\fP \fBlocale\fP & __loc)\fC [inherited]\fP"

.PP
Moves to a new locale\&. 
.PP
\fBParameters\fP
.RS 4
\fI__loc\fP The new locale\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The previous locale\&.
.RE
.PP
Calls \fCios_base::imbue(loc)\fP, and if a stream buffer is associated with this stream, calls that buffer's \fCpubimbue(loc)\fP\&.
.PP
Additional l10n notes are at http://gcc.gnu.org/onlinedocs/libstdc++/manual/localization.html 
.PP
References \fBstd::ios_base::imbue()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBvoid\fP \fBstd::basic_ios\fP< _CharT, _Traits >::init (\fBbasic_streambuf\fP< _CharT, _Traits > * __sb)\fC [protected]\fP, \fC [inherited]\fP"

.PP
All setup is performed here\&. This is called from the public constructor\&. It is not virtual and cannot be redefined\&. 
.PP
Referenced by \fBstd::basic_ios< _CharT, _Traits >::basic_ios()\fP\&.
.SS "long & std::ios_base::iword (int __ix)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Access to integer array\&. 
.PP
\fBParameters\fP
.RS 4
\fI__ix\fP Index into the array\&. 
.RE
.PP
\fBReturns\fP
.RS 4
A reference to an integer associated with the index\&.
.RE
.PP
The iword function provides access to an array of integers that can be used for any purpose\&. The array grows as required to hold the supplied index\&. All integers in the array are initialized to 0\&.
.PP
The implementation reserves several indices\&. You should use xalloc to obtain an index that is safe to use\&. Also note that since the array can grow dynamically, it is not safe to hold onto the reference\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > char \fBstd::basic_ios\fP< _CharT, _Traits >::narrow (\fBchar_type\fP __c, char __dfault) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Squeezes characters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The character to narrow\&. 
.br
\fI__dfault\fP The character to narrow\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The narrowed character\&.
.RE
.PP
Maps a character of \fCchar_type\fP to a character of \fCchar\fP, if possible\&.
.PP
Returns the result of 
.PP
.nf
std::use_facet<ctype<char_type> >(getloc())\&.narrow(c,dfault)

.fi
.PP
.PP
Additional l10n notes are at http://gcc.gnu.org/onlinedocs/libstdc++/manual/localization.html 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBstd::basic_ios\fP< _CharT, _Traits >::operator bool () const\fC [inline]\fP, \fC [explicit]\fP, \fC [inherited]\fP"

.PP
The quick-and-easy status check\&. This allows you to write constructs such as \fCif (!a_stream) \&.\&.\&.\fP and \fCwhile (a_stream) \&.\&.\&.\fP 
.PP
References \fBstd::basic_ios< _CharT, _Traits >::fail()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > bool \fBstd::basic_ios\fP< _CharT, _Traits >::operator! () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
The quick-and-easy status check\&. This allows you to write constructs such as \fCif (!a_stream) \&.\&.\&.\fP and \fCwhile (a_stream) \&.\&.\&.\fP 
.PP
References \fBstd::basic_ios< _CharT, _Traits >::fail()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (\fB__ios_type\fP &(*)(\fB__ios_type\fP &) __pf)\fC [inline]\fP"

.PP
Interface for manipulators\&. Manipulators such as \fCstd::ws\fP and \fCstd::dec\fP use these functions in constructs like \fCstd::cin >> std::ws\fP\&. For more information, see the iomanip header\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (\fB__istream_type\fP &(*)(\fB__istream_type\fP &) __pf)\fC [inline]\fP"

.PP
Interface for manipulators\&. Manipulators such as \fCstd::ws\fP and \fCstd::dec\fP use these functions in constructs like \fCstd::cin >> std::ws\fP\&. For more information, see the iomanip header\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (\fB__streambuf_type\fP * __sb)"

.PP
Extracting into another streambuf\&. 
.PP
\fBParameters\fP
.RS 4
\fI__sb\fP A pointer to a streambuf
.RE
.PP
This function behaves like one of the basic arithmetic extractors, in that it also constructs a sentry object and has the same error handling behavior\&.
.PP
If \fC__sb\fP is NULL, the stream will set failbit in its error state\&.
.PP
Characters are extracted from this stream and inserted into the \fC__sb\fP streambuf until one of the following occurs:
.PP
.IP "\(bu" 2
the input stream reaches end-of-file,
.IP "\(bu" 2
insertion into the output buffer fails (in this case, the character that would have been inserted is not extracted), or
.IP "\(bu" 2
an exception occurs (and in this case is caught)
.PP
.PP
If the function inserts no characters, failbit is set\&. 
.PP
References \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::failbit\fP, \fBstd::ios_base::goodbit\fP, \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP, and \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (bool & __n)\fC [inline]\fP"

.PP
Integer arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (double & __f)\fC [inline]\fP"

.PP
Floating point arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__f\fP A variable of builtin floating point type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (float & __f)\fC [inline]\fP"

.PP
Floating point arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__f\fP A variable of builtin floating point type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (int & __n)"

.PP
Integer arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (\fBios_base\fP &(*)(\fBios_base\fP &) __pf)\fC [inline]\fP"

.PP
Interface for manipulators\&. Manipulators such as \fCstd::ws\fP and \fCstd::dec\fP use these functions in constructs like \fCstd::cin >> std::ws\fP\&. For more information, see the iomanip header\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (long & __n)\fC [inline]\fP"

.PP
Integer arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (long double & __f)\fC [inline]\fP"

.PP
Floating point arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__f\fP A variable of builtin floating point type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (long long & __n)\fC [inline]\fP"

.PP
Integer arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (short & __n)"

.PP
Integer arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.PP
References \fBstd::ios_base::badbit\fP, \fBstd::ios_base::failbit\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (unsigned int & __n)\fC [inline]\fP"

.PP
Integer arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (unsigned long & __n)\fC [inline]\fP"

.PP
Integer arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (unsigned long long & __n)\fC [inline]\fP"

.PP
Integer arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (unsigned short & __n)\fC [inline]\fP"

.PP
Integer arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (\fBvoid\fP *& __p)\fC [inline]\fP"

.PP
Basic arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__p\fP A variable of pointer type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to parse the input data\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits >::int_type \fBstd::basic_istream\fP< _CharT, _Traits >::peek (\fBvoid\fP)"

.PP
Looking ahead in the stream\&. 
.PP
\fBReturns\fP
.RS 4
The next character, or eof()\&.
.RE
.PP
If, after constructing the sentry object, \fCgood()\fP is false, returns \fCtraits::eof()\fP\&. Otherwise reads but does not extract the next input character\&. 
.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP, \fBstd::ios_base::badbit\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::goodbit\fP, \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP, and \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP\&.
.SS "\fBstreamsize\fP std::ios_base::precision () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Flags access\&. 
.PP
\fBReturns\fP
.RS 4
The precision to generate on certain output operations\&.
.RE
.PP
Be careful if you try to give a definition of \fIprecision\fP here; see DR 189\&. 
.SS "\fBstreamsize\fP std::ios_base::precision (\fBstreamsize\fP __prec)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Changing flags\&. 
.PP
\fBParameters\fP
.RS 4
\fI__prec\fP The new precision value\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The previous value of precision()\&. 
.RE
.PP

.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::putback (char_type __c)"

.PP
Unextracting a single character\&. 
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The character to push back into the input stream\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
If \fCrdbuf()\fP is not null, calls \fCrdbuf()->sputbackc(c)\fP\&.
.PP
If \fCrdbuf()\fP is null or if \fCsputbackc()\fP fails, sets badbit in the error state\&.
.PP
\fBNote\fP
.RS 4
This function first clears eofbit\&. Since no characters are extracted, the next call to \fCgcount()\fP will return 0, as required by DR 60\&. 
.RE
.PP

.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP, \fBstd::ios_base::badbit\fP, \fBstd::basic_ios< _CharT, _Traits >::clear()\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::goodbit\fP, \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP, \fBstd::basic_ios< _CharT, _Traits >::rdstate()\fP, and \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP\&.
.SS "\fBvoid\fP *& std::ios_base::pword (int __ix)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Access to void pointer array\&. 
.PP
\fBParameters\fP
.RS 4
\fI__ix\fP Index into the array\&. 
.RE
.PP
\fBReturns\fP
.RS 4
A reference to a void* associated with the index\&.
.RE
.PP
The pword function provides access to an array of pointers that can be used for any purpose\&. The array grows as required to hold the supplied index\&. All pointers in the array are initialized to 0\&.
.PP
The implementation reserves several indices\&. You should use xalloc to obtain an index that is safe to use\&. Also note that since the array can grow dynamically, it is not safe to hold onto the reference\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_streambuf\fP< _CharT, _Traits > * \fBstd::basic_ios\fP< _CharT, _Traits >::rdbuf () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Accessing the underlying buffer\&. 
.PP
\fBReturns\fP
.RS 4
The current stream buffer\&.
.RE
.PP
This does not change the state of the stream\&. 
.PP
Referenced by \fBstd::basic_istream< char >::sentry::sentry()\fP, \fBstd::basic_ostream< _CharT, _Traits >::flush()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< char >::getline()\fP, \fBstd::basic_istream< _CharT, _Traits >::ignore()\fP, \fBstd::basic_istream< _CharT, _Traits >::ignore()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::basic_istream< _CharT, _Traits >::peek()\fP, \fBstd::basic_ostream< _CharT, _Traits >::put()\fP, \fBstd::basic_istream< _CharT, _Traits >::putback()\fP, \fBstd::basic_istream< _CharT, _Traits >::read()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< char >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_istream< _CharT, _Traits >::sync()\fP, \fBstd::basic_istream< _CharT, _Traits >::tellg()\fP, \fBstd::basic_ostream< _CharT, _Traits >::tellp()\fP, and \fBstd::basic_istream< _CharT, _Traits >::unget()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_streambuf\fP< _CharT, _Traits > * \fBstd::basic_ios\fP< _CharT, _Traits >::rdbuf (\fBbasic_streambuf\fP< _CharT, _Traits > * __sb)\fC [inherited]\fP"

.PP
Changing the underlying buffer\&. 
.PP
\fBParameters\fP
.RS 4
\fI__sb\fP The new stream buffer\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The previous stream buffer\&.
.RE
.PP
Associates a new buffer with the current stream, and clears the error state\&.
.PP
Due to historical accidents which the LWG refuses to correct, the I/O library suffers from a design error: this function is hidden in derived classes by overrides of the zero-argument \fCrdbuf()\fP, which is non-virtual for hysterical raisins\&. As a result, you must use explicit qualifications to access this function via any derived class\&. For example:
.PP
.PP
.nf
std::fstream     foo;         // or some other derived type
std::streambuf*  p = \&.\&.\&.\&.\&.;

foo\&.ios::rdbuf(p);            // ios == basic_ios<char>
.fi
.PP
 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBiostate\fP \fBstd::basic_ios\fP< _CharT, _Traits >::rdstate () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Returns the error state of the stream buffer\&. 
.PP
\fBReturns\fP
.RS 4
A bit pattern (well, isn't everything?)
.RE
.PP
See std::ios_base::iostate for the possible bit values\&. Most users will call one of the interpreting wrappers, e\&.g\&., good()\&. 
.PP
Referenced by \fBstd::basic_ios< _CharT, _Traits >::bad()\fP, \fBstd::basic_ios< _CharT, _Traits >::eof()\fP, \fBstd::basic_ios< _CharT, _Traits >::fail()\fP, \fBstd::basic_ios< _CharT, _Traits >::good()\fP, \fBstd::basic_istream< _CharT, _Traits >::putback()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP, and \fBstd::basic_istream< _CharT, _Traits >::unget()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::read (char_type * __s, \fBstreamsize\fP __n)"

.PP
Extraction without delimiters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__s\fP A character array\&. 
.br
\fI__n\fP Maximum number of characters to store\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
If the stream state is \fCgood()\fP, extracts characters and stores them into \fI__s\fP until one of the following happens:
.IP "\(bu" 2
\fI__n\fP characters are stored
.IP "\(bu" 2
the input sequence reaches end-of-file, in which case the error state is set to \fCfailbit|eofbit\fP\&.
.PP
.PP
\fBNote\fP
.RS 4
This function is not overloaded on signed char and unsigned char\&. 
.RE
.PP

.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP, \fBstd::ios_base::badbit\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::failbit\fP, \fBstd::ios_base::goodbit\fP, \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP, and \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBstreamsize\fP \fBstd::basic_istream\fP< _CharT, _Traits >::readsome (char_type * __s, \fBstreamsize\fP __n)"

.PP
Extraction until the buffer is exhausted, but no more\&. 
.PP
\fBParameters\fP
.RS 4
\fI__s\fP A character array\&. 
.br
\fI__n\fP Maximum number of characters to store\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The number of characters extracted\&.
.RE
.PP
Extracts characters and stores them into \fI__s\fP depending on the number of characters remaining in the streambuf's buffer, \fCrdbuf()->in_avail()\fP, called \fCA\fP here:
.IP "\(bu" 2
if \fCA\fP \fC==\fP \fC-1\fP, sets eofbit and extracts no characters
.IP "\(bu" 2
if \fCA\fP \fC==\fP \fC0\fP, extracts no characters
.IP "\(bu" 2
if \fCA\fP \fC>\fP \fC0\fP, extracts \fCmin(A,n)\fP 
.PP
.PP
The goal is to empty the current buffer, and to not request any more from the external input sequence controlled by the streambuf\&. 
.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP, and \fBstd::ios_base::goodbit\fP\&.
.SS "\fBvoid\fP std::ios_base::register_callback (\fBevent_callback\fP __fn, int __index)\fC [inherited]\fP"

.PP
Add the callback __fn with parameter __index\&. 
.PP
\fBParameters\fP
.RS 4
\fI__fn\fP The function to add\&. 
.br
\fI__index\fP The integer to pass to the function when invoked\&.
.RE
.PP
Registers a function as an event callback with an integer parameter to be passed to the function when invoked\&. Multiple copies of the function are allowed\&. If there are multiple callbacks, they are invoked in the order they were registered\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::seekg (off_type __off, \fBios_base::seekdir\fP __dir)"

.PP
Changing the current read position\&. 
.PP
\fBParameters\fP
.RS 4
\fI__off\fP A file offset object\&. 
.br
\fI__dir\fP The direction in which to seek\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
If \fCfail()\fP is not true, calls \fCrdbuf()->pubseekoff(__off,__dir)\fP\&. If that function fails, sets failbit\&.
.PP
\fBNote\fP
.RS 4
This function first clears eofbit\&. It does not count the number of characters extracted, if any, and therefore does not affect the next call to \fCgcount()\fP\&. 
.RE
.PP

.PP
References \fBstd::ios_base::badbit\fP, \fBstd::basic_ios< _CharT, _Traits >::clear()\fP, \fBstd::ios_base::eofbit\fP, \fBstd::basic_ios< _CharT, _Traits >::fail()\fP, \fBstd::ios_base::failbit\fP, \fBstd::ios_base::goodbit\fP, \fBstd::ios_base::in\fP, \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP, \fBstd::basic_ios< _CharT, _Traits >::rdstate()\fP, and \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::seekg (pos_type __pos)"

.PP
Changing the current read position\&. 
.PP
\fBParameters\fP
.RS 4
\fI__pos\fP A file position object\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
If \fCfail()\fP is not true, calls \fCrdbuf()->pubseekpos(__pos)\fP\&. If that function fails, sets failbit\&.
.PP
\fBNote\fP
.RS 4
This function first clears eofbit\&. It does not count the number of characters extracted, if any, and therefore does not affect the next call to \fCgcount()\fP\&. 
.RE
.PP

.PP
References \fBstd::ios_base::badbit\fP, \fBstd::basic_ios< _CharT, _Traits >::clear()\fP, \fBstd::ios_base::eofbit\fP, \fBstd::basic_ios< _CharT, _Traits >::fail()\fP, \fBstd::ios_base::failbit\fP, \fBstd::ios_base::goodbit\fP, \fBstd::ios_base::in\fP, \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP, \fBstd::basic_ios< _CharT, _Traits >::rdstate()\fP, and \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP\&.
.SS "\fBfmtflags\fP std::ios_base::setf (\fBfmtflags\fP __fmtfl)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Setting new format flags\&. 
.PP
\fBParameters\fP
.RS 4
\fI__fmtfl\fP Additional flags to set\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The previous format control flags\&.
.RE
.PP
This function sets additional flags in format control\&. Flags that were previously set remain set\&. 
.SS "\fBfmtflags\fP std::ios_base::setf (\fBfmtflags\fP __fmtfl, \fBfmtflags\fP __mask)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Setting new format flags\&. 
.PP
\fBParameters\fP
.RS 4
\fI__fmtfl\fP Additional flags to set\&. 
.br
\fI__mask\fP The flags mask for \fIfmtfl\fP\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The previous format control flags\&.
.RE
.PP
This function clears \fImask\fP in the format flags, then sets \fIfmtfl\fP \fC&\fP \fImask\fP\&. An example mask is \fCios_base::adjustfield\fP\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBvoid\fP \fBstd::basic_ios\fP< _CharT, _Traits >::setstate (\fBiostate\fP __state)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Sets additional flags in the error state\&. 
.PP
\fBParameters\fP
.RS 4
\fI__state\fP The additional state flag(s) to set\&.
.RE
.PP
See std::ios_base::iostate for the possible bit values\&. 
.PP
References \fBstd::basic_ios< _CharT, _Traits >::clear()\fP, and \fBstd::basic_ios< _CharT, _Traits >::rdstate()\fP\&.
.PP
Referenced by \fBstd::basic_ostream< _CharT, _Traits >::flush()\fP, \fBstd::basic_ostream< _CharT, _Traits >::operator<<()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::basic_istream< _CharT, _Traits >::peek()\fP, \fBstd::basic_ostream< _CharT, _Traits >::put()\fP, \fBstd::basic_istream< _CharT, _Traits >::putback()\fP, \fBstd::basic_istream< _CharT, _Traits >::read()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_istream< _CharT, _Traits >::sync()\fP, and \fBstd::basic_istream< _CharT, _Traits >::unget()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > int \fBstd::basic_istream\fP< _CharT, _Traits >::sync (\fBvoid\fP)"

.PP
Synchronizing the stream buffer\&. 
.PP
\fBReturns\fP
.RS 4
0 on success, -1 on failure
.RE
.PP
If \fCrdbuf()\fP is a null pointer, returns -1\&.
.PP
Otherwise, calls \fCrdbuf()->pubsync()\fP, and if that returns -1, sets badbit and returns -1\&.
.PP
Otherwise, returns 0\&.
.PP
\fBNote\fP
.RS 4
This function does not count the number of characters extracted, if any, and therefore does not affect the next call to \fCgcount()\fP\&. 
.RE
.PP

.PP
References \fBstd::ios_base::badbit\fP, \fBstd::ios_base::goodbit\fP, \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP, and \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP\&.
.SS "\fBstatic\fP bool std::ios_base::sync_with_stdio (bool __sync = \fC\fBtrue\fP\fP)\fC [static]\fP, \fC [inherited]\fP"

.PP
Interaction with the standard C I/O objects\&. 
.PP
\fBParameters\fP
.RS 4
\fI__sync\fP Whether to synchronize or not\&. 
.RE
.PP
\fBReturns\fP
.RS 4
True if the standard streams were previously synchronized\&.
.RE
.PP
The synchronization referred to is \fIonly\fP that between the standard C facilities (e\&.g\&., stdout) and the standard C++ objects (e\&.g\&., cout)\&. User-declared streams are unaffected\&. See https://gcc.gnu.org/onlinedocs/libstdc++/manual/fstreams.html#std.io.filestreams.binary 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits >::pos_type \fBstd::basic_istream\fP< _CharT, _Traits >::tellg (\fBvoid\fP)"

.PP
Getting the current read position\&. 
.PP
\fBReturns\fP
.RS 4
A file position object\&.
.RE
.PP
If \fCfail()\fP is not false, returns \fCpos_type\fP(-1) to indicate failure\&. Otherwise returns \fCrdbuf()->pubseekoff(0,cur,in)\fP\&.
.PP
\fBNote\fP
.RS 4
This function does not count the number of characters extracted, if any, and therefore does not affect the next call to \fCgcount()\fP\&. At variance with putback, unget and seekg, eofbit is not cleared first\&. 
.RE
.PP

.PP
References \fBstd::ios_base::badbit\fP, \fBstd::ios_base::cur\fP, \fBstd::basic_ios< _CharT, _Traits >::fail()\fP, \fBstd::ios_base::in\fP, and \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_ostream\fP< _CharT, _Traits > * \fBstd::basic_ios\fP< _CharT, _Traits >::tie () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Fetches the current \fItied\fP stream\&. 
.PP
\fBReturns\fP
.RS 4
A pointer to the tied stream, or NULL if the stream is not tied\&.
.RE
.PP
A stream may be \fItied\fP (or synchronized) to a second output stream\&. When this stream performs any I/O, the tied stream is first flushed\&. For example, \fCstd::cin\fP is tied to \fCstd::cout\fP\&. 
.PP
Referenced by \fBstd::basic_ios< _CharT, _Traits >::copyfmt()\fP\&.
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_ostream\fP< _CharT, _Traits > * \fBstd::basic_ios\fP< _CharT, _Traits >::tie (\fBbasic_ostream\fP< _CharT, _Traits > * __tiestr)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Ties this stream to an output stream\&. 
.PP
\fBParameters\fP
.RS 4
\fI__tiestr\fP The output stream\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The previously tied output stream, or NULL if the stream was not tied\&.
.RE
.PP
This sets up a new tie; see tie() for more\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::unget (\fBvoid\fP)"

.PP
Unextracting the previous character\&. 
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
If \fCrdbuf()\fP is not null, calls \fCrdbuf()->sungetc(c)\fP\&.
.PP
If \fCrdbuf()\fP is null or if \fCsungetc()\fP fails, sets badbit in the error state\&.
.PP
\fBNote\fP
.RS 4
This function first clears eofbit\&. Since no characters are extracted, the next call to \fCgcount()\fP will return 0, as required by DR 60\&. 
.RE
.PP

.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP, \fBstd::ios_base::badbit\fP, \fBstd::basic_ios< _CharT, _Traits >::clear()\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::goodbit\fP, \fBstd::basic_ios< _CharT, _Traits >::rdbuf()\fP, \fBstd::basic_ios< _CharT, _Traits >::rdstate()\fP, and \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP\&.
.SS "\fBvoid\fP std::ios_base::unsetf (\fBfmtflags\fP __mask)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Clearing format flags\&. 
.PP
\fBParameters\fP
.RS 4
\fI__mask\fP The flags to unset\&.
.RE
.PP
This function clears \fI__mask\fP in the format flags\&. 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > char_type \fBstd::basic_ios\fP< _CharT, _Traits >::widen (char __c) const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Widens characters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The character to widen\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The widened character\&.
.RE
.PP
Maps a character of \fCchar\fP to a character of \fCchar_type\fP\&.
.PP
Returns the result of 
.PP
.nf
std::use_facet<ctype<char_type> >(getloc())\&.widen(c)

.fi
.PP
.PP
Additional l10n notes are at http://gcc.gnu.org/onlinedocs/libstdc++/manual/localization.html 
.PP
Referenced by \fBstd::basic_ios< _CharT, _Traits >::fill()\fP\&.
.SS "\fBstreamsize\fP std::ios_base::width () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Flags access\&. 
.PP
\fBReturns\fP
.RS 4
The minimum field width to generate on output operations\&.
.RE
.PP
\fIMinimum field width\fP refers to the number of characters\&. 
.SS "\fBstreamsize\fP std::ios_base::width (\fBstreamsize\fP __wide)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Changing flags\&. 
.PP
\fBParameters\fP
.RS 4
\fI__wide\fP The new width value\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The previous value of width()\&. 
.RE
.PP

.SS "\fBstatic\fP int std::ios_base::xalloc ()\fC [static]\fP, \fC [inherited]\fP"

.PP
Access to unique indices\&. 
.PP
\fBReturns\fP
.RS 4
An integer different from all previous calls\&.
.RE
.PP
This function returns a unique integer every time it is called\&. It can be used for any purpose, but is primarily intended to be a unique index for the iword and pword functions\&. The expectation is that an application calls xalloc in order to obtain an index in the iword and pword arrays that can be used without fear of conflict\&.
.PP
The implementation maintains a static variable that is incremented and returned on each invocation\&. xalloc is guaranteed to return an index that is safe to use in the iword and pword arrays\&. 
.SH "Member Data Documentation"
.PP 
.SS "template<\fBtypename\fP _CharT , \fBtypename\fP _Traits > \fBstreamsize\fP \fBstd::basic_istream\fP< _CharT, _Traits >::_M_gcount\fC [protected]\fP"
The number of characters extracted in the previous unformatted function; see gcount()\&. 
.PP
Referenced by \fBstd::basic_istream< char >::sentry::sentry()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< char >::getline()\fP, \fBstd::basic_istream< _CharT, _Traits >::ignore()\fP, \fBstd::basic_istream< _CharT, _Traits >::ignore()\fP, \fBstd::basic_istream< _CharT, _Traits >::ignore()\fP, \fBstd::basic_istream< _CharT, _Traits >::peek()\fP, \fBstd::basic_istream< _CharT, _Traits >::putback()\fP, \fBstd::basic_istream< char >::putback()\fP, \fBstd::basic_istream< _CharT, _Traits >::read()\fP, \fBstd::basic_istream< _CharT, _Traits >::readsome()\fP, \fBstd::basic_istream< char >::seekg()\fP, \fBstd::basic_istream< char >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::unget()\fP, and \fBstd::basic_istream< char >::unget()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::adjustfield\fC [static]\fP, \fC [inherited]\fP"

.PP
A mask of left|right|internal\&. Useful for the 2-arg form of \fCsetf\fP\&. 
.PP
Referenced by \fBstd::num_put< _CharT, _OutIter >::do_put()\fP, \fBstd::internal()\fP, \fBstd::left()\fP, and \fBstd::right()\fP\&.
.SS "\fBconst\fP \fBopenmode\fP std::ios_base::app\fC [static]\fP, \fC [inherited]\fP"

.PP
Seek to end before each write\&. 
.PP
Referenced by \fBstd::basic_filebuf< _CharT, _Traits >::overflow()\fP, and \fBstd::basic_filebuf< _CharT, _Traits >::xsputn()\fP\&.
.SS "\fBconst\fP \fBopenmode\fP std::ios_base::ate\fC [static]\fP, \fC [inherited]\fP"

.PP
Open and seek to end immediately after opening\&. 
.PP
Referenced by \fBstd::basic_filebuf< _CharT, _Traits >::open()\fP\&.
.SS "\fBconst\fP \fBiostate\fP std::ios_base::badbit\fC [static]\fP, \fC [inherited]\fP"

.PP
Indicates a loss of integrity in an input or output sequence (such as an irrecoverable read error from a file)\&. 
.PP
Referenced by \fBstd::basic_istream< _CharT, _Traits >::sentry::sentry()\fP, \fBstd::basic_ios< _CharT, _Traits >::bad()\fP, \fBstd::basic_ios< _CharT, _Traits >::fail()\fP, \fBstd::basic_ostream< _CharT, _Traits >::flush()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< char >::get()\fP, \fBstd::basic_istream< char >::ignore()\fP, \fBstd::basic_ostream< _CharT, _Traits >::operator<<()\fP, \fBstd::operator>>()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::basic_istream< _CharT, _Traits >::peek()\fP, \fBstd::basic_ostream< _CharT, _Traits >::put()\fP, \fBstd::basic_istream< _CharT, _Traits >::putback()\fP, \fBstd::basic_istream< _CharT, _Traits >::read()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_istream< _CharT, _Traits >::sync()\fP, \fBstd::basic_istream< _CharT, _Traits >::tellg()\fP, \fBstd::basic_ostream< _CharT, _Traits >::tellp()\fP, and \fBstd::basic_istream< _CharT, _Traits >::unget()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::basefield\fC [static]\fP, \fC [inherited]\fP"

.PP
A mask of dec|oct|hex\&. Useful for the 2-arg form of \fCsetf\fP\&. 
.PP
Referenced by \fBstd::dec()\fP, \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::num_put< _CharT, _OutIter >::do_put()\fP, \fBstd::hex()\fP, and \fBstd::oct()\fP\&.
.SS "\fBconst\fP \fBseekdir\fP std::ios_base::beg\fC [static]\fP, \fC [inherited]\fP"

.PP
Request a seek relative to the beginning of the stream\&. 
.PP
Referenced by \fBstd::basic_filebuf< _CharT, _Traits >::seekpos()\fP\&.
.SS "\fBconst\fP \fBopenmode\fP std::ios_base::binary\fC [static]\fP, \fC [inherited]\fP"

.PP
Perform input and output in binary mode (as opposed to text mode)\&. This is probably not what you think it is; see https://gcc.gnu.org/onlinedocs/libstdc++/manual/fstreams.html#std.io.filestreams.binary\&. 
.PP
Referenced by \fBstd::basic_filebuf< _CharT, _Traits >::showmanyc()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::boolalpha\fC [static]\fP, \fC [inherited]\fP"

.PP
Insert/extract \fCbool\fP in alphabetic rather than numeric format\&. 
.PP
Referenced by \fBstd::boolalpha()\fP, \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::num_put< _CharT, _OutIter >::do_put()\fP, and \fBstd::noboolalpha()\fP\&.
.SS "\fBconst\fP \fBseekdir\fP std::ios_base::cur\fC [static]\fP, \fC [inherited]\fP"

.PP
Request a seek relative to the current position within the sequence\&. 
.PP
Referenced by \fBstd::basic_filebuf< _CharT, _Traits >::imbue()\fP, \fBstd::basic_filebuf< _CharT, _Traits >::overflow()\fP, \fBstd::basic_filebuf< _CharT, _Traits >::pbackfail()\fP, \fBstd::basic_filebuf< _CharT, _Traits >::seekoff()\fP, \fBstd::basic_stringbuf< _CharT, _Traits, _Alloc >::seekoff()\fP, \fBstd::basic_istream< _CharT, _Traits >::tellg()\fP, and \fBstd::basic_ostream< _CharT, _Traits >::tellp()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::dec\fC [static]\fP, \fC [inherited]\fP"

.PP
Converts integer input or generates integer output in decimal base\&. 
.PP
Referenced by \fBstd::dec()\fP\&.
.SS "\fBconst\fP \fBseekdir\fP std::ios_base::end\fC [static]\fP, \fC [inherited]\fP"

.PP
Request a seek relative to the current end of the sequence\&. 
.PP
Referenced by \fBstd::basic_filebuf< _CharT, _Traits >::open()\fP, and \fBstd::basic_stringbuf< _CharT, _Traits, _Alloc >::seekoff()\fP\&.
.SS "\fBconst\fP \fBiostate\fP std::ios_base::eofbit\fC [static]\fP, \fC [inherited]\fP"

.PP
Indicates that an input operation reached the end of an input sequence\&. 
.PP
Referenced by \fBstd::basic_istream< _CharT, _Traits >::sentry::sentry()\fP, \fBstd::basic_istream< char >::sentry::sentry()\fP, \fBstd::time_get< _CharT, _InIter >::do_get()\fP, \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::time_get< _CharT, _InIter >::do_get_date()\fP, \fBstd::time_get< _CharT, _InIter >::do_get_monthname()\fP, \fBstd::time_get< _CharT, _InIter >::do_get_time()\fP, \fBstd::time_get< _CharT, _InIter >::do_get_weekday()\fP, \fBstd::time_get< _CharT, _InIter >::do_get_year()\fP, \fBstd::basic_ios< _CharT, _Traits >::eof()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::time_get< _CharT, _InIter >::get()\fP, \fBstd::basic_istream< char >::getline()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::operator>>()\fP, \fBstd::basic_istream< _CharT, _Traits >::peek()\fP, \fBstd::basic_istream< _CharT, _Traits >::putback()\fP, \fBstd::basic_istream< _CharT, _Traits >::read()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< char >::sync()\fP, \fBstd::basic_istream< _CharT, _Traits >::unget()\fP, and \fBstd::ws()\fP\&.
.SS "\fBconst\fP \fBiostate\fP std::ios_base::failbit\fC [static]\fP, \fC [inherited]\fP"

.PP
Indicates that an input operation failed to read the expected characters, or that an output operation failed to generate the desired characters\&. 
.PP
Referenced by \fBstd::basic_istream< _CharT, _Traits >::sentry::sentry()\fP, \fBstd::basic_ostream< _CharT, _Traits >::sentry::sentry()\fP, \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::time_get< _CharT, _InIter >::do_get_monthname()\fP, \fBstd::time_get< _CharT, _InIter >::do_get_weekday()\fP, \fBstd::time_get< _CharT, _InIter >::do_get_year()\fP, \fBstd::basic_ios< _CharT, _Traits >::fail()\fP, \fBstd::time_get< _CharT, _InIter >::get()\fP, \fBstd::basic_istream< char >::getline()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::operator>>()\fP, \fBstd::basic_istream< char >::operator>>()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::basic_istream< _CharT, _Traits >::read()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, and \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::fixed\fC [static]\fP, \fC [inherited]\fP"

.PP
Generate floating-point output in fixed-point notation\&. 
.PP
Referenced by \fBstd::fixed()\fP, and \fBstd::hexfloat()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::floatfield\fC [static]\fP, \fC [inherited]\fP"

.PP
A mask of scientific|fixed\&. Useful for the 2-arg form of \fCsetf\fP\&. 
.PP
Referenced by \fBstd::defaultfloat()\fP, \fBstd::fixed()\fP, \fBstd::hexfloat()\fP, and \fBstd::scientific()\fP\&.
.SS "\fBconst\fP \fBiostate\fP std::ios_base::goodbit\fC [static]\fP, \fC [inherited]\fP"

.PP
Indicates all is well\&. 
.PP
Referenced by \fBstd::basic_istream< _CharT, _Traits >::sentry::sentry()\fP, \fBstd::time_get< _CharT, _InIter >::do_get()\fP, \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::time_get< _CharT, _InIter >::do_get_monthname()\fP, \fBstd::time_get< _CharT, _InIter >::do_get_weekday()\fP, \fBstd::time_get< _CharT, _InIter >::do_get_year()\fP, \fBstd::basic_ostream< _CharT, _Traits >::flush()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::time_get< _CharT, _InIter >::get()\fP, \fBstd::basic_istream< char >::getline()\fP, \fBstd::basic_istream< _CharT, _Traits >::ignore()\fP, \fBstd::basic_istream< _CharT, _Traits >::ignore()\fP, \fBstd::basic_istream< _CharT, _Traits >::ignore()\fP, \fBstd::basic_ostream< _CharT, _Traits >::operator<<()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::operator>>()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::basic_istream< char >::operator>>()\fP, \fBstd::basic_istream< _CharT, _Traits >::peek()\fP, \fBstd::basic_ostream< _CharT, _Traits >::put()\fP, \fBstd::basic_istream< _CharT, _Traits >::putback()\fP, \fBstd::basic_istream< _CharT, _Traits >::read()\fP, \fBstd::basic_istream< _CharT, _Traits >::readsome()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_istream< _CharT, _Traits >::sync()\fP, and \fBstd::basic_istream< _CharT, _Traits >::unget()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::hex\fC [static]\fP, \fC [inherited]\fP"

.PP
Converts integer input or generates integer output in hexadecimal base\&. 
.PP
Referenced by \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::num_put< _CharT, _OutIter >::do_put()\fP, and \fBstd::hex()\fP\&.
.SS "\fBconst\fP \fBopenmode\fP std::ios_base::in\fC [static]\fP, \fC [inherited]\fP"

.PP
Open for input\&. Default for \fCifstream\fP and fstream\&. 
.PP
Referenced by \fBstd::basic_stringbuf< _CharT, _Traits, _Alloc >::overflow()\fP, \fBstd::basic_filebuf< _CharT, _Traits >::pbackfail()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_stringbuf< _CharT, _Traits, _Alloc >::seekoff()\fP, \fBstd::basic_stringbuf< _CharT, _Traits, _Alloc >::seekpos()\fP, \fBstd::basic_filebuf< _CharT, _Traits >::showmanyc()\fP, \fBstd::basic_istream< _CharT, _Traits >::tellg()\fP, \fBstd::basic_filebuf< _CharT, _Traits >::underflow()\fP, \fBstd::basic_stringbuf< _CharT, _Traits, _Alloc >::underflow()\fP, and \fBstd::basic_filebuf< _CharT, _Traits >::xsgetn()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::internal\fC [static]\fP, \fC [inherited]\fP"

.PP
Adds fill characters at a designated internal point in certain generated output, or identical to \fCright\fP if no such point is designated\&. 
.PP
Referenced by \fBstd::internal()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::left\fC [static]\fP, \fC [inherited]\fP"

.PP
Adds fill characters on the right (final positions) of certain generated output\&. (I\&.e\&., the thing you print is flush left\&.) 
.PP
Referenced by \fBstd::num_put< _CharT, _OutIter >::do_put()\fP, and \fBstd::left()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::oct\fC [static]\fP, \fC [inherited]\fP"

.PP
Converts integer input or generates integer output in octal base\&. 
.PP
Referenced by \fBstd::oct()\fP\&.
.SS "\fBconst\fP \fBopenmode\fP std::ios_base::out\fC [static]\fP, \fC [inherited]\fP"

.PP
Open for output\&. Default for \fCofstream\fP and fstream\&. 
.PP
Referenced by \fBstd::basic_filebuf< _CharT, _Traits >::overflow()\fP, \fBstd::basic_stringbuf< _CharT, _Traits, _Alloc >::overflow()\fP, \fBstd::basic_stringbuf< _CharT, _Traits, _Alloc >::pbackfail()\fP, \fBstd::basic_stringbuf< _CharT, _Traits, _Alloc >::seekoff()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_stringbuf< _CharT, _Traits, _Alloc >::seekpos()\fP, \fBstd::basic_ostream< _CharT, _Traits >::tellp()\fP, and \fBstd::basic_filebuf< _CharT, _Traits >::xsputn()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::right\fC [static]\fP, \fC [inherited]\fP"

.PP
Adds fill characters on the left (initial positions) of certain generated output\&. (I\&.e\&., the thing you print is flush right\&.) 
.PP
Referenced by \fBstd::right()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::scientific\fC [static]\fP, \fC [inherited]\fP"

.PP
Generates floating-point output in scientific notation\&. 
.PP
Referenced by \fBstd::hexfloat()\fP, and \fBstd::scientific()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::showbase\fC [static]\fP, \fC [inherited]\fP"

.PP
Generates a prefix indicating the numeric base of generated integer output\&. 
.PP
Referenced by \fBstd::num_put< _CharT, _OutIter >::do_put()\fP, \fBstd::noshowbase()\fP, and \fBstd::showbase()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::showpoint\fC [static]\fP, \fC [inherited]\fP"

.PP
Generates a decimal-point character unconditionally in generated floating-point output\&. 
.PP
Referenced by \fBstd::noshowpoint()\fP, and \fBstd::showpoint()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::showpos\fC [static]\fP, \fC [inherited]\fP"

.PP
Generates a + sign in non-negative generated numeric output\&. 
.PP
Referenced by \fBstd::noshowpos()\fP, and \fBstd::showpos()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::skipws\fC [static]\fP, \fC [inherited]\fP"

.PP
Skips leading white space before certain input operations\&. 
.PP
Referenced by \fBstd::basic_istream< _CharT, _Traits >::sentry::sentry()\fP, \fBstd::noskipws()\fP, \fBstd::__detail::operator>>()\fP, and \fBstd::skipws()\fP\&.
.SS "\fBconst\fP \fBopenmode\fP std::ios_base::trunc\fC [static]\fP, \fC [inherited]\fP"

.PP
Truncate an existing stream when opening\&. Default for \fCofstream\fP\&. 
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::unitbuf\fC [static]\fP, \fC [inherited]\fP"

.PP
Flushes output after each output operation\&. 
.PP
Referenced by \fBstd::nounitbuf()\fP, and \fBstd::unitbuf()\fP\&.
.SS "\fBconst\fP \fBfmtflags\fP std::ios_base::uppercase\fC [static]\fP, \fC [inherited]\fP"

.PP
Replaces certain lowercase letters with their uppercase equivalents in generated output\&. 
.PP
Referenced by \fBstd::num_put< _CharT, _OutIter >::do_put()\fP, \fBstd::nouppercase()\fP, and \fBstd::uppercase()\fP\&.

.SH "Author"
.PP 
Generated automatically by Doxygen for libstdc++ from the source code\&.