.TH "std::basic_istringstream< _CharT, _Traits, _Alloc >" 3 "libstdc++" \" -*- nroff -*-
.ad l
.nh
.SH NAME
std::basic_istringstream< _CharT, _Traits, _Alloc > \- Controlling input for std::string\&.  

.SH SYNOPSIS
.br
.PP
.PP
\fR#include <sstream>\fP
.PP
Inherits \fBstd::basic_istream< _CharT, _Traits >\fP\&.
.SS "Public Types"

.in +1c
.ti -1c
.RI "typedef \fBctype\fP< _CharT > \fB__ctype_type\fP"
.br
.ti -1c
.RI "typedef \fBbasic_ios\fP< _CharT, _Traits > \fB__ios_type\fP"
.br
.ti -1c
.RI "typedef \fBbasic_istream\fP< char_type, traits_type > \fB__istream_type\fP"
.br
.ti -1c
.RI "typedef \fBnum_get\fP< _CharT, \fBistreambuf_iterator\fP< _CharT, _Traits > > \fB__num_get_type\fP"
.br
.ti -1c
.RI "typedef \fBbasic_streambuf\fP< _CharT, _Traits > \fB__streambuf_type\fP"
.br
.ti -1c
.RI "typedef \fBbasic_string\fP< _CharT, _Traits, _Alloc > \fB__string_type\fP"
.br
.ti -1c
.RI "typedef \fBbasic_stringbuf\fP< _CharT, _Traits, _Alloc > \fB__stringbuf_type\fP"
.br
.ti -1c
.RI "typedef _Alloc \fBallocator_type\fP"
.br
.ti -1c
.RI "typedef _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 "typedef void(*) \fBevent_callback\fP(\fBevent\fP __e, \fBios_base\fP &__b, int __i)"
.br
.RI "The type of an event callback function\&. "
.ti -1c
.RI "typedef class __attribute((__abi_tag__('cxx11'))) failure typedef _Ios_Fmtflags \fBfmtflags\fP"
.br
.RI "These are thrown to indicate problems with io\&. "
.ti -1c
.RI "typedef traits_type::int_type \fBint_type\fP"
.br
.ti -1c
.RI "typedef _Ios_Iostate \fBiostate\fP"
.br
.RI "This is a bitmask type\&. "
.ti -1c
.RI "typedef traits_type::off_type \fBoff_type\fP"
.br
.ti -1c
.RI "typedef _Ios_Openmode \fBopenmode\fP"
.br
.RI "This is a bitmask type\&. "
.ti -1c
.RI "typedef traits_type::pos_type \fBpos_type\fP"
.br
.ti -1c
.RI "typedef _Ios_Seekdir \fBseekdir\fP"
.br
.RI "This is an enumerated type\&. "
.ti -1c
.RI "typedef _Traits \fBtraits_type\fP"
.br
.in -1c
.PP
.RI "\fB\fP"
.br

.in +1c
.in +1c
.ti -1c
.RI "typedef \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_istringstream\fP ()"
.br
.RI "Default constructor starts with an empty string buffer\&. "
.ti -1c
.RI "\fBbasic_istringstream\fP (\fB__string_type\fP &&__str, \fBios_base::openmode\fP __mode=\fBios_base::in\fP)"
.br
.ti -1c
.RI "\fBbasic_istringstream\fP (\fBbasic_istringstream\fP &&__rhs)"
.br
.ti -1c
.RI "\fBbasic_istringstream\fP (const \fB__string_type\fP &__str, \fBios_base::openmode\fP __mode=\fBios_base::in\fP)"
.br
.RI "Starts with an existing string buffer\&. "
.ti -1c
.RI "\fBbasic_istringstream\fP (const \fBbasic_istringstream\fP &)=delete"
.br
.ti -1c
.RI "template<typename _SAlloc > \fBbasic_istringstream\fP (const \fBbasic_string\fP< _CharT, _Traits, _SAlloc > &__str, const allocator_type &__a)"
.br
.ti -1c
.RI "template<typename _SAlloc > \fBbasic_istringstream\fP (const \fBbasic_string\fP< _CharT, _Traits, _SAlloc > &__str, \fBios_base::openmode\fP __mode, const allocator_type &__a)"
.br
.ti -1c
.RI "template<typename _SAlloc > \fBbasic_istringstream\fP (const \fBbasic_string\fP< _CharT, _Traits, _SAlloc > &__str, \fBios_base::openmode\fP __mode=\fBios_base::in\fP)"
.br
.ti -1c
.RI "\fBbasic_istringstream\fP (\fBios_base::openmode\fP __mode)"
.br
.RI "Starts with an empty string buffer\&. "
.ti -1c
.RI "\fBbasic_istringstream\fP (\fBios_base::openmode\fP __mode, const allocator_type &__a)"
.br
.ti -1c
.RI "\fB~basic_istringstream\fP ()"
.br
.RI "The destructor does nothing\&. "
.ti -1c
.RI "template<typename _ValueT > \fBbasic_istream\fP< _CharT, _Traits > & \fB_M_extract\fP (_ValueT &__v)"
.br
.ti -1c
.RI "const \fBlocale\fP & \fB_M_getloc\fP () const"
.br
.RI "Locale access\&. "
.ti -1c
.RI "void \fB_M_setstate\fP (\fBiostate\fP __state)"
.br
.ti -1c
.RI "bool \fBbad\fP () const"
.br
.RI "Fast error checking\&. "
.ti -1c
.RI "void \fBclear\fP (\fBiostate\fP __state=\fBgoodbit\fP)"
.br
.RI "[Re]sets the error state\&. "
.ti -1c
.RI "\fBbasic_ios\fP & \fBcopyfmt\fP (const \fBbasic_ios\fP &__rhs)"
.br
.RI "Copies fields of __rhs into this\&. "
.ti -1c
.RI "bool \fBeof\fP () const"
.br
.RI "Fast error checking\&. "
.ti -1c
.RI "\fBiostate\fP \fBexceptions\fP () const"
.br
.RI "Throwing exceptions on errors\&. "
.ti -1c
.RI "void \fBexceptions\fP (\fBiostate\fP __except)"
.br
.RI "Throwing exceptions on errors\&. "
.ti -1c
.RI "bool \fBfail\fP () const"
.br
.RI "Fast error checking\&. "
.ti -1c
.RI "char_type \fBfill\fP () const"
.br
.RI "Retrieves the \fIempty\fP character\&. "
.ti -1c
.RI "char_type \fBfill\fP (char_type __ch)"
.br
.RI "Sets a new \fIempty\fP character\&. "
.ti -1c
.RI "\fBfmtflags\fP \fBflags\fP () const"
.br
.RI "Access to format flags\&. "
.ti -1c
.RI "\fBfmtflags\fP \fBflags\fP (\fBfmtflags\fP __fmtfl)"
.br
.RI "Setting new format flags all at once\&. "
.ti -1c
.RI "\fBstreamsize\fP \fBgcount\fP () const"
.br
.RI "Character counting\&. "
.ti -1c
.RI "\fBbasic_istream\fP< char > & \fBgetline\fP (char_type *__s, \fBstreamsize\fP __n, char_type __delim)"
.br
.RI "Explicit specialization declarations, defined in src/istream\&.cc\&. "
.ti -1c
.RI "\fBbasic_istream\fP< wchar_t > & \fBgetline\fP (char_type *__s, \fBstreamsize\fP __n, char_type __delim)"
.br
.ti -1c
.RI "\fBlocale\fP \fBgetloc\fP () const"
.br
.RI "Locale access\&. "
.ti -1c
.RI "bool \fBgood\fP () const"
.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 __delim)"
.br
.ti -1c
.RI "\fBbasic_istream\fP< wchar_t > & \fBignore\fP (\fBstreamsize\fP __n, int_type __delim)"
.br
.ti -1c
.RI "\fBlocale\fP \fBimbue\fP (const \fBlocale\fP &__loc)"
.br
.RI "Moves to a new locale\&. "
.ti -1c
.RI "long & \fBiword\fP (int __ix)"
.br
.RI "Access to integer array\&. "
.ti -1c
.RI "char \fBnarrow\fP (char_type __c, char __dfault) const"
.br
.RI "Squeezes characters\&. "
.ti -1c
.RI "\fBbasic_istringstream\fP & \fBoperator=\fP (\fBbasic_istringstream\fP &&__rhs)"
.br
.ti -1c
.RI "\fBbasic_istringstream\fP & \fBoperator=\fP (const \fBbasic_istringstream\fP &)=delete"
.br
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (\fB__streambuf_type\fP *__sb)"
.br
.RI "Extracting into another streambuf\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (void *&__p)"
.br
.RI "Basic arithmetic extractors\&. "
.ti -1c
.RI "\fBstreamsize\fP \fBprecision\fP () const"
.br
.RI "Flags access\&. "
.ti -1c
.RI "\fBstreamsize\fP \fBprecision\fP (\fBstreamsize\fP __prec)"
.br
.RI "Changing flags\&. "
.ti -1c
.RI "void *& \fBpword\fP (int __ix)"
.br
.RI "Access to void pointer array\&. "
.ti -1c
.RI "\fBbasic_streambuf\fP< _CharT, _Traits > * \fBrdbuf\fP (\fBbasic_streambuf\fP< _CharT, _Traits > *__sb)"
.br
.RI "Changing the underlying buffer\&. "
.ti -1c
.RI "__stringbuf_type * \fBrdbuf\fP () const"
.br
.RI "Accessing the underlying buffer\&. "
.ti -1c
.RI "\fBiostate\fP \fBrdstate\fP () const"
.br
.RI "Returns the error state of the stream buffer\&. "
.ti -1c
.RI "void \fBregister_callback\fP (\fBevent_callback\fP __fn, int __index)"
.br
.RI "Add the callback __fn with parameter __index\&. "
.ti -1c
.RI "\fBfmtflags\fP \fBsetf\fP (\fBfmtflags\fP __fmtfl)"
.br
.RI "Setting new format flags\&. "
.ti -1c
.RI "\fBfmtflags\fP \fBsetf\fP (\fBfmtflags\fP __fmtfl, \fBfmtflags\fP __mask)"
.br
.RI "Setting new format flags\&. "
.ti -1c
.RI "void \fBsetstate\fP (\fBiostate\fP __state)"
.br
.RI "Sets additional flags in the error state\&. "
.ti -1c
.RI "\fB__string_type\fP \fBstr\fP () &&"
.br
.ti -1c
.RI "\fB__string_type\fP \fBstr\fP () const &"
.br
.RI "Copying out the string buffer\&. "
.ti -1c
.RI "void \fBstr\fP (\fB__string_type\fP &&__s)"
.br
.ti -1c
.RI "void \fBstr\fP (const \fB__string_type\fP &__s)"
.br
.RI "Setting a new buffer\&. "
.ti -1c
.RI "template<__allocator_like _SAlloc> \fBbasic_string\fP< _CharT, _Traits, _SAlloc > \fBstr\fP (const _SAlloc &__sa) const"
.br
.ti -1c
.RI "template<__allocator_like _SAlloc> 
.br
requires (!is_same_v<_SAlloc, _Alloc>)void \fBstr\fP (const \fBbasic_string\fP< _CharT, _Traits, _SAlloc > &__s)"
.br
.ti -1c
.RI "void \fBswap\fP (\fBbasic_istringstream\fP &__rhs)"
.br
.ti -1c
.RI "\fBbasic_ostream\fP< _CharT, _Traits > * \fBtie\fP () const"
.br
.RI "Fetches the current \fItied\fP stream\&. "
.ti -1c
.RI "\fBbasic_ostream\fP< _CharT, _Traits > * \fBtie\fP (\fBbasic_ostream\fP< _CharT, _Traits > *__tiestr)"
.br
.RI "Ties this stream to an output stream\&. "
.ti -1c
.RI "void \fBunsetf\fP (\fBfmtflags\fP __mask)"
.br
.RI "Clearing format flags\&. "
.ti -1c
.RI "\fBbasic_string_view\fP< char_type, traits_type > \fBview\fP () const noexcept"
.br
.ti -1c
.RI "char_type \fBwiden\fP (char __c) const"
.br
.RI "Widens characters\&. "
.ti -1c
.RI "\fBstreamsize\fP \fBwidth\fP () const"
.br
.RI "Flags access\&. "
.ti -1c
.RI "\fBstreamsize\fP \fBwidth\fP (\fBstreamsize\fP __wide)"
.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 &(*__pf)(\fB__istream_type\fP &))"
.br
.RI "Interface for manipulators\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (\fB__ios_type\fP &(*__pf)(\fB__ios_type\fP &))"
.br
.RI "Interface for manipulators\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBoperator>>\fP (\fBios_base\fP &(*__pf)(\fBios_base\fP &))"
.br
.RI "Interface for manipulators\&. "
.in -1c
.in -1c
.PP
.RI "\fBExtractors\fP"
.br
All the \fRoperator>>\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 *__s, \fBstreamsize\fP __n, char_type __delim)"
.br
.RI "Simple multiple-character extraction\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBget\fP (char_type *__s, \fBstreamsize\fP __n)"
.br
.RI "Simple multiple-character extraction\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBget\fP (\fB__streambuf_type\fP &__sb, char_type __delim)"
.br
.RI "Extraction into another streambuf\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBget\fP (\fB__streambuf_type\fP &__sb)"
.br
.RI "Extraction into another streambuf\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBgetline\fP (char_type *__s, \fBstreamsize\fP __n, char_type __delim)"
.br
.RI "String extraction\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBgetline\fP (char_type *__s, \fBstreamsize\fP __n)"
.br
.RI "String extraction\&. "
.ti -1c
.RI "\fB__istream_type\fP & \fBignore\fP (\fBstreamsize\fP __n, int_type __delim)"
.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 *__s, \fBstreamsize\fP __n)"
.br
.RI "Extraction without delimiters\&. "
.ti -1c
.RI "\fBstreamsize\fP \fBreadsome\fP (char_type *__s, \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 () const"
.br
.RI "The quick-and-easy status check\&. "
.ti -1c
.RI "bool \fBoperator!\fP () const"
.br
.RI "The quick-and-easy status check\&. "
.in -1c
.in -1c
.SS "Static Public Member Functions"

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

.in +1c
.ti -1c
.RI "static const \fBopenmode\fP \fB__noreplace\fP"
.br
.ti -1c
.RI "static const \fBfmtflags\fP \fBadjustfield\fP"
.br
.RI "A mask of left|right|internal\&. Useful for the 2-arg form of \fRsetf\fP\&. "
.ti -1c
.RI "static const \fBopenmode\fP \fBapp\fP"
.br
.RI "Seek to end before each write\&. "
.ti -1c
.RI "static const \fBopenmode\fP \fBate\fP"
.br
.RI "Open and seek to end immediately after opening\&. "
.ti -1c
.RI "static const \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 "static const \fBfmtflags\fP \fBbasefield\fP"
.br
.RI "A mask of dec|oct|hex\&. Useful for the 2-arg form of \fRsetf\fP\&. "
.ti -1c
.RI "static const \fBseekdir\fP \fBbeg\fP"
.br
.RI "Request a seek relative to the beginning of the stream\&. "
.ti -1c
.RI "static const \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 "static const \fBfmtflags\fP \fBboolalpha\fP"
.br
.RI "Insert/extract \fRbool\fP in alphabetic rather than numeric format\&. "
.ti -1c
.RI "static const \fBseekdir\fP \fBcur\fP"
.br
.RI "Request a seek relative to the current position within the sequence\&. "
.ti -1c
.RI "static const \fBfmtflags\fP \fBdec\fP"
.br
.RI "Converts integer input or generates integer output in decimal base\&. "
.ti -1c
.RI "static const \fBseekdir\fP \fBend\fP"
.br
.RI "Request a seek relative to the current end of the sequence\&. "
.ti -1c
.RI "static const \fBiostate\fP \fBeofbit\fP"
.br
.RI "Indicates that an input operation reached the end of an input sequence\&. "
.ti -1c
.RI "static const \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 "static const \fBfmtflags\fP \fBfixed\fP"
.br
.RI "Generate floating-point output in fixed-point notation\&. "
.ti -1c
.RI "static const \fBfmtflags\fP \fBfloatfield\fP"
.br
.RI "A mask of scientific|fixed\&. Useful for the 2-arg form of \fRsetf\fP\&. "
.ti -1c
.RI "static const \fBiostate\fP \fBgoodbit\fP"
.br
.RI "Indicates all is well\&. "
.ti -1c
.RI "static const \fBfmtflags\fP \fBhex\fP"
.br
.RI "Converts integer input or generates integer output in hexadecimal base\&. "
.ti -1c
.RI "static const \fBopenmode\fP \fBin\fP"
.br
.RI "Open for input\&. Default for \fRifstream\fP and fstream\&. "
.ti -1c
.RI "static const \fBfmtflags\fP \fBinternal\fP"
.br
.RI "Adds fill characters at a designated internal point in certain generated output, or identical to \fRright\fP if no such point is designated\&. "
.ti -1c
.RI "static const \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 "static const \fBfmtflags\fP \fBoct\fP"
.br
.RI "Converts integer input or generates integer output in octal base\&. "
.ti -1c
.RI "static const \fBopenmode\fP \fBout\fP"
.br
.RI "Open for output\&. Default for \fRofstream\fP and fstream\&. "
.ti -1c
.RI "static const \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 "static const \fBfmtflags\fP \fBscientific\fP"
.br
.RI "Generates floating-point output in scientific notation\&. "
.ti -1c
.RI "static const \fBfmtflags\fP \fBshowbase\fP"
.br
.RI "Generates a prefix indicating the numeric base of generated integer output\&. "
.ti -1c
.RI "static const \fBfmtflags\fP \fBshowpoint\fP"
.br
.RI "Generates a decimal-point character unconditionally in generated floating-point output\&. "
.ti -1c
.RI "static const \fBfmtflags\fP \fBshowpos\fP"
.br
.RI "Generates a + sign in non-negative generated numeric output\&. "
.ti -1c
.RI "static const \fBfmtflags\fP \fBskipws\fP"
.br
.RI "Skips leading white space before certain input operations\&. "
.ti -1c
.RI "static const \fBopenmode\fP \fBtrunc\fP"
.br
.RI "Truncate an existing stream when opening\&. Default for \fRofstream\fP\&. "
.ti -1c
.RI "static const \fBfmtflags\fP \fBunitbuf\fP"
.br
.RI "Flushes output after each output operation\&. "
.ti -1c
.RI "static const \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 "void \fB_M_cache_locale\fP (const \fBlocale\fP &__loc)"
.br
.ti -1c
.RI "void \fB_M_call_callbacks\fP (\fBevent\fP __ev)  throw ()"
.br
.ti -1c
.RI "void \fB_M_dispose_callbacks\fP (void)  throw ()"
.br
.ti -1c
.RI "template<typename _ValueT > \fB__istream_type\fP & \fB_M_extract\fP (_ValueT &__v)"
.br
.ti -1c
.RI "_Words & \fB_M_grow_words\fP (int __index, bool __iword)"
.br
.ti -1c
.RI "void \fB_M_init\fP ()  throw ()"
.br
.ti -1c
.RI "void \fB_M_move\fP (\fBios_base\fP &) noexcept"
.br
.ti -1c
.RI "void \fB_M_swap\fP (\fBios_base\fP &__rhs) noexcept"
.br
.ti -1c
.RI "void \fBinit\fP (\fBbasic_streambuf\fP< _CharT, _Traits > *__sb)"
.br
.RI "All setup is performed here\&. "
.ti -1c
.RI "void \fBmove\fP (\fBbasic_ios\fP &&__rhs)"
.br
.ti -1c
.RI "void \fBmove\fP (\fBbasic_ios\fP &__rhs)"
.br
.ti -1c
.RI "void \fBset_rdbuf\fP (\fBbasic_streambuf\fP< _CharT, _Traits > *__sb)"
.br
.ti -1c
.RI "void \fBswap\fP (\fBbasic_ios\fP &__rhs) noexcept"
.br
.ti -1c
.RI "void \fBswap\fP (\fBbasic_istream\fP &__rhs)"
.br
.in -1c
.SS "Protected Attributes"

.in +1c
.ti -1c
.RI "_Callback_list * \fB_M_callbacks\fP"
.br
.ti -1c
.RI "const \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 "const \fB__num_get_type\fP * \fB_M_num_get\fP"
.br
.ti -1c
.RI "const \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
.SH "Detailed Description"
.PP 

.SS "template<typename _CharT, typename _Traits, typename _Alloc>
.br
class std::basic_istringstream< _CharT, _Traits, _Alloc >"Controlling input for std::string\&. 


.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>\&. 
.br
\fI_Alloc\fP Allocator type, defaults to allocator<_CharT>\&.
.RE
.PP
This class supports reading from objects of type std::basic_string, using the inherited functions from std::basic_istream\&. To control the associated sequence, an instance of std::basic_stringbuf is used, which this page refers to as \fRsb\fP\&. 
.SH "Member Typedef Documentation"
.PP 
.SS "template<typename _CharT , typename _Traits > \fBnum_put\fP<_CharT, \fBostreambuf_iterator\fP<_CharT, _Traits> > \fBstd::basic_ios\fP< _CharT, _Traits >::__num_put_type\fR [inherited]\fP"
These are non-standard types\&. 
.SS "void(*) std::ios_base::event_callback(\fBevent\fP __e, \fBios_base\fP &__b, int __i)\fR [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 "_Ios_Iostate std::ios_base::iostate\fR [inherited]\fP"

.PP
This is a bitmask type\&. \fR\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 "_Ios_Openmode std::ios_base::openmode\fR [inherited]\fP"

.PP
This is a bitmask type\&. \fR\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 "_Ios_Seekdir std::ios_base::seekdir\fR [inherited]\fP"

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

.SH "Member Enumeration Documentation"
.PP 
.SS "enum \fBstd::ios_base::event\fP\fR [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<typename _CharT , typename _Traits , typename _Alloc > \fBstd::basic_istringstream\fP< _CharT, _Traits, _Alloc >::basic_istringstream ()\fR [inline]\fP"

.PP
Default constructor starts with an empty string buffer\&. Initializes \fRsb\fP using \fRin\fP, and passes \fR&sb\fP to the base class initializer\&. Does not allocate any buffer\&.

.PP
That's a lie\&. We initialize the base class with NULL, because the string class does its own memory management\&. 
.PP
References \fBstd::basic_ios< _CharT, _Traits >::init()\fP\&.
.SS "template<typename _CharT , typename _Traits , typename _Alloc > \fBstd::basic_istringstream\fP< _CharT, _Traits, _Alloc >::basic_istringstream (\fBios_base::openmode\fP __mode)\fR [inline]\fP, \fR [explicit]\fP"

.PP
Starts with an empty string buffer\&. 
.PP
\fBParameters\fP
.RS 4
\fI__mode\fP Whether the buffer can read, or write, or both\&.
.RE
.PP
\fRios_base::in\fP is automatically included in \fI__mode\fP\&.

.PP
Initializes \fRsb\fP using \fR__mode|in\fP, and passes \fR&sb\fP to the base class initializer\&. Does not allocate any buffer\&.

.PP
That's a lie\&. We initialize the base class with NULL, because the string class does its own memory management\&. 
.PP
References \fBstd::basic_ios< _CharT, _Traits >::init()\fP\&.
.SS "template<typename _CharT , typename _Traits , typename _Alloc > \fBstd::basic_istringstream\fP< _CharT, _Traits, _Alloc >::basic_istringstream (const \fB__string_type\fP & __str, \fBios_base::openmode\fP __mode = \fR\fBios_base::in\fP\fP)\fR [inline]\fP, \fR [explicit]\fP"

.PP
Starts with an existing string buffer\&. 
.PP
\fBParameters\fP
.RS 4
\fI__str\fP A string to copy as a starting buffer\&. 
.br
\fI__mode\fP Whether the buffer can read, or write, or both\&.
.RE
.PP
\fRios_base::in\fP is automatically included in \fImode\fP\&.

.PP
Initializes \fRsb\fP using \fIstr\fP and \fRmode|in\fP, and passes \fR&sb\fP to the base class initializer\&.

.PP
That's a lie\&. We initialize the base class with NULL, because the string class does its own memory management\&. 
.PP
References \fBstd::basic_ios< _CharT, _Traits >::init()\fP\&.
.SS "template<typename _CharT , typename _Traits , typename _Alloc > \fBstd::basic_istringstream\fP< _CharT, _Traits, _Alloc >::~\fBbasic_istringstream\fP ()\fR [inline]\fP"

.PP
The destructor does nothing\&. The buffer is deallocated by the stringbuf object, not the formatting stream\&. 
.SH "Member Function Documentation"
.PP 
.SS "const \fBlocale\fP & std::ios_base::_M_getloc () const\fR [inline]\fP, \fR [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\&. 
.PP
Referenced by \fBstd::money_get< _CharT, _InIter >::do_get()\fP, \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::time_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, istreambuf_iterator< _CharT > >::do_get_weekday()\fP, \fBstd::time_get< _CharT, _InIter >::do_get_year()\fP, \fBstd::num_put< _CharT, _OutIter >::do_put()\fP, \fBstd::time_put< _CharT, _OutIter >::do_put()\fP, \fBstd::time_get< _CharT, _InIter >::get()\fP, and \fBstd::time_put< _CharT, _OutIter >::put()\fP\&.
.SS "template<typename _CharT , typename _Traits > bool \fBstd::basic_ios\fP< _CharT, _Traits >::bad () const\fR [inline]\fP, \fR [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\&.
.PP
Referenced by \fBstd::basic_ostream< _CharT, _Traits >::sentry::sentry()\fP\&.
.SS "template<typename _CharT , typename _Traits > void \fBstd::basic_ios\fP< _CharT, _Traits >::clear (\fBiostate\fP __state = \fR\fBgoodbit\fP\fP)\fR [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_fstream< _CharT, _Traits >::open()\fP, \fBstd::basic_fstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::open()\fP, \fBstd::__detail::operator>>()\fP, and \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_ios\fP< _CharT, _Traits > & \fBstd::basic_ios\fP< _CharT, _Traits >::copyfmt (const \fBbasic_ios\fP< _CharT, _Traits > & __rhs)\fR [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::__addressof()\fP, \fBstd::basic_ios< _CharT, _Traits >::exceptions()\fP, \fBstd::basic_ios< _CharT, _Traits >::fill()\fP, \fBstd::ios_base::flags()\fP, \fBstd::ios_base::getloc()\fP, \fBstd::ios_base::precision()\fP, \fBstd::basic_ios< _CharT, _Traits >::tie()\fP, \fBstd::tie()\fP, and \fBstd::ios_base::width()\fP\&.
.SS "template<typename _CharT , typename _Traits > bool \fBstd::basic_ios\fP< _CharT, _Traits >::eof () const\fR [inline]\fP, \fR [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<typename _CharT , typename _Traits > \fBiostate\fP \fBstd::basic_ios\fP< _CharT, _Traits >::exceptions () const\fR [inline]\fP, \fR [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\&. 
.PP
Referenced by \fBstd::basic_ios< _CharT, _Traits >::copyfmt()\fP\&.
.SS "template<typename _CharT , typename _Traits > void \fBstd::basic_ios\fP< _CharT, _Traits >::exceptions (\fBiostate\fP __except)\fR [inline]\fP, \fR [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<typename _CharT , typename _Traits > bool \fBstd::basic_ios\fP< _CharT, _Traits >::fail () const\fR [inline]\fP, \fR [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_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_ostream< _CharT, _Traits >::tellp()\fP, and \fBstd::regex_traits< typename >::value()\fP\&.
.SS "template<typename _CharT , typename _Traits > char_type \fBstd::basic_ios\fP< _CharT, _Traits >::fill () const\fR [inline]\fP, \fR [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 >::copyfmt()\fP, and \fBstd::basic_ios< _CharT, _Traits >::fill()\fP\&.
.SS "template<typename _CharT , typename _Traits > char_type \fBstd::basic_ios\fP< _CharT, _Traits >::fill (\fBchar_type\fP __ch)\fR [inline]\fP, \fR [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\fR [inline]\fP, \fR [inherited]\fP"

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

.PP
Referenced by \fBstd::basic_ostream< _CharT, _Traits >::sentry::~sentry()\fP, \fBstd::basic_ios< _CharT, _Traits >::copyfmt()\fP, \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::num_put< _CharT, _OutIter >::do_put()\fP, \fBstd::num_put< _CharT, _OutIter >::do_put()\fP, \fBstd::chrono::operator<<()\fP, \fBstd::operator<<()\fP, \fBstd::__detail::operator>>()\fP, \fBstd::operator>>()\fP, \fBstd::operator>>()\fP, \fBstd::operator>>()\fP, \fBstd::operator>>()\fP, \fBstd::operator>>()\fP, \fBstd::operator>>()\fP, and \fBstd::operator>>()\fP\&.
.SS "\fBfmtflags\fP std::ios_base::flags (\fBfmtflags\fP __fmtfl)\fR [inline]\fP, \fR [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<typename _CharT , typename _Traits > \fBstreamsize\fP \fBstd::basic_istream\fP< _CharT, _Traits >::gcount () const\fR [inline]\fP, \fR [inherited]\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

.PP
References \fBstd::basic_istream< _CharT, _Traits >::_M_gcount\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits >::int_type \fBstd::basic_istream\fP< _CharT, _Traits >::get (void )\fR [inherited]\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::ios_base::badbit\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::failbit\fP, and \fBstd::ios_base::goodbit\fP\&.
.PP
Referenced by \fBstd::basic_istream< _CharT, _Traits >::get()\fP, and \fBstd::basic_istream< _CharT, _Traits >::get()\fP\&.
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::get (\fB__streambuf_type\fP & __sb)\fR [inline]\fP, \fR [inherited]\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 \fRget\fP(__sb,widen('\\n'))\&. 
.PP
References \fBstd::basic_istream< _CharT, _Traits >::get()\fP, and \fBstd::basic_ios< _CharT, _Traits >::widen()\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::get (\fB__streambuf_type\fP & __sb, char_type __delim)\fR [inherited]\fP"

.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::ios_base::goodbit\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::get (char_type & __c)\fR [inherited]\fP"

.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::ios_base::badbit\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::failbit\fP, and \fBstd::ios_base::goodbit\fP\&.
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::get (char_type * __s, \fBstreamsize\fP __n)\fR [inline]\fP, \fR [inherited]\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 \fRget\fP(__s,__n,widen('\\n'))\&. 
.PP
References \fBstd::basic_istream< _CharT, _Traits >::get()\fP, and \fBstd::basic_ios< _CharT, _Traits >::widen()\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::get (char_type * __s, \fBstreamsize\fP __n, char_type __delim)\fR [inherited]\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 \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
\fR__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::ios_base::goodbit\fP, and \fBstd::basic_streambuf< _CharT, _Traits >::sgetc()\fP\&.
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >::getline (char_type * __s, \fBstreamsize\fP __n)\fR [inline]\fP, \fR [inherited]\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 \fRgetline\fP(__s,__n,widen('\\n'))\&. 
.PP
References \fBstd::basic_istream< _CharT, _Traits >::getline()\fP, and \fBstd::basic_ios< _CharT, _Traits >::widen()\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::getline (char_type * __s, \fBstreamsize\fP __n, char_type __delim)\fR [inherited]\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\&. 
.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 \fR__delim\fP, in which case the character is extracted (and therefore counted in \fRgcount()\fP) but not stored
.IP "3." 4
\fR__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\&. 
.PP
Referenced by \fBstd::basic_istream< _CharT, _Traits >::getline()\fP\&.
.SS "\fBbasic_istream\fP< char > & \fBstd::basic_istream\fP< char >::getline (char_type * __s, \fBstreamsize\fP __n, char_type __delim)\fR [inherited]\fP"

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

.PP
Locale access\&. 
.PP
\fBReturns\fP
.RS 4
A copy of the current locale\&.
.RE
.PP
If \fRimbue(loc)\fP has previously been called, then this function returns \fRloc\fP\&. Otherwise, it returns a copy of \fRstd::locale()\fP, the global C++ locale\&. 
.PP
Referenced by \fBstd::basic_ios< _CharT, _Traits >::copyfmt()\fP, \fBstd::money_put< _CharT, _OutIter >::do_put()\fP, \fBstd::chrono::operator<<()\fP, \fBstd::operator>>()\fP, \fBstd::operator>>()\fP, and \fBstd::ws()\fP\&.
.SS "template<typename _CharT , typename _Traits > bool \fBstd::basic_ios\fP< _CharT, _Traits >::good () const\fR [inline]\fP, \fR [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\&.
.PP
Referenced by \fBstd::basic_istream< _CharT, _Traits >::sentry::sentry()\fP, \fBstd::basic_ostream< _CharT, _Traits >::sentry::sentry()\fP, and \fBstd::__detail::operator>>()\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::ignore (void )\fR [inherited]\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::ios_base::eofbit\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::basic_streambuf< _CharT, _Traits >::sbumpc()\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::ignore (\fBstreamsize\fP __n)\fR [inherited]\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::ios_base::goodbit\fP, and \fBstd::basic_streambuf< _CharT, _Traits >::sgetc()\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::ignore (\fBstreamsize\fP __n, int_type __delim)\fR [inherited]\fP"

.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 \fR!=\fP \fRstd::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 \fRtraits::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\&. 
.SS "template<typename _CharT , typename _Traits > \fBlocale\fP \fBstd::basic_ios\fP< _CharT, _Traits >::imbue (const \fBlocale\fP & __loc)\fR [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 \fRios_base::imbue(loc)\fP, and if a stream buffer is associated with this stream, calls that buffer's \fRpubimbue(loc)\fP\&.

.PP
Additional l10n notes are at http://gcc.gnu.org/onlinedocs/libstdc++/manual/localization.html 
.PP
References \fBstd::ios_base::imbue()\fP\&.
.PP
Referenced by \fBstd::chrono::operator<<()\fP\&.
.SS "template<typename _CharT , typename _Traits > void \fBstd::basic_ios\fP< _CharT, _Traits >::init (\fBbasic_streambuf\fP< _CharT, _Traits > * __sb)\fR [protected]\fP, \fR [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_fstream< _CharT, _Traits >::basic_fstream()\fP, \fBstd::basic_fstream< _CharT, _Traits >::basic_fstream()\fP, \fBstd::basic_fstream< _CharT, _Traits >::basic_fstream()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::basic_ifstream()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::basic_ifstream()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::basic_ifstream()\fP, \fBstd::basic_ios< _CharT, _Traits >::basic_ios()\fP, \fBstd::basic_istream< _CharT, _Traits >::basic_istream()\fP, \fBstd::basic_istringstream< _CharT, _Traits, _Alloc >::basic_istringstream()\fP, \fBstd::basic_istringstream< _CharT, _Traits, _Alloc >::basic_istringstream()\fP, \fBstd::basic_istringstream< _CharT, _Traits, _Alloc >::basic_istringstream()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::basic_ofstream()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::basic_ofstream()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::basic_ofstream()\fP, \fBstd::basic_ostream< _CharT, _Traits >::basic_ostream()\fP, \fBstd::basic_ostringstream< _CharT, _Traits, _Alloc >::basic_ostringstream()\fP, \fBstd::basic_ostringstream< _CharT, _Traits, _Alloc >::basic_ostringstream()\fP, \fBstd::basic_ostringstream< _CharT, _Traits, _Alloc >::basic_ostringstream()\fP, \fBstd::basic_stringstream< _CharT, _Traits, _Alloc >::basic_stringstream()\fP, \fBstd::basic_stringstream< _CharT, _Traits, _Alloc >::basic_stringstream()\fP, and \fBstd::basic_stringstream< _CharT, _Traits, _Alloc >::basic_stringstream()\fP\&.
.SS "long & std::ios_base::iword (int __ix)\fR [inline]\fP, \fR [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<typename _CharT , typename _Traits > char \fBstd::basic_ios\fP< _CharT, _Traits >::narrow (\fBchar_type\fP __c, char __dfault) const\fR [inline]\fP, \fR [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 \fRchar_type\fP to a character of \fRchar\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<typename _CharT , typename _Traits > \fBstd::basic_ios\fP< _CharT, _Traits >\fB::operator\fP bool () const\fR [inline]\fP, \fR [explicit]\fP, \fR [inherited]\fP"

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

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

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

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

.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 \fR__sb\fP is NULL, the stream will set failbit in its error state\&.

.PP
Characters are extracted from this stream and inserted into the \fR__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, and \fBstd::ios_base::goodbit\fP\&.
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (bool & __n)\fR [inline]\fP, \fR [inherited]\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
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (double & __f)\fR [inline]\fP, \fR [inherited]\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
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (float & __f)\fR [inline]\fP, \fR [inherited]\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
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (int & __n)\fR [inherited]\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
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (\fBios_base\fP &(* __pf )(\fBios_base\fP &))\fR [inline]\fP, \fR [inherited]\fP"

.PP
Interface for manipulators\&. Manipulators such as \fRstd::ws\fP and \fRstd::dec\fP use these functions in constructs like \fRstd::cin >> std::ws\fP\&. For more information, see the iomanip header\&. 
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (long & __n)\fR [inline]\fP, \fR [inherited]\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
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (long double & __f)\fR [inline]\fP, \fR [inherited]\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
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (long long & __n)\fR [inline]\fP, \fR [inherited]\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
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (short & __n)\fR [inherited]\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
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.PP
References \fBstd::ios_base::badbit\fP, \fBstd::ios_base::failbit\fP, \fBstd::num_get< _CharT, _InIter >::get()\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::use_facet()\fP\&.
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (unsigned int & __n)\fR [inline]\fP, \fR [inherited]\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
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (unsigned long & __n)\fR [inline]\fP, \fR [inherited]\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
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (unsigned long long & __n)\fR [inline]\fP, \fR [inherited]\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
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (unsigned short & __n)\fR [inline]\fP, \fR [inherited]\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
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.SS "template<typename _CharT , typename _Traits > \fB__istream_type\fP & \fBstd::basic_istream\fP< _CharT, _Traits >\fB::operator\fP>> (void *& __p)\fR [inline]\fP, \fR [inherited]\fP"

.PP
Basic arithmetic extractors\&. 
.PP
\fBParameters\fP
.RS 4
\fI__p\fP A variable of pointer type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fR*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fRnum_get\fP facet) to parse the input data\&. 
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits >::int_type \fBstd::basic_istream\fP< _CharT, _Traits >::peek (void )\fR [inherited]\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, \fRgood()\fP is false, returns \fRtraits::eof()\fP\&. Otherwise reads but does not extract the next input character\&. 
.SS "\fBstreamsize\fP std::ios_base::precision () const\fR [inline]\fP, \fR [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\&. 
.PP
Referenced by \fBstd::basic_ios< _CharT, _Traits >::copyfmt()\fP, and \fBstd::chrono::operator<<()\fP\&.
.SS "\fBstreamsize\fP std::ios_base::precision (\fBstreamsize\fP __prec)\fR [inline]\fP, \fR [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<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::putback (char_type __c)\fR [inherited]\fP"

.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 \fRrdbuf()\fP is not null, calls \fRrdbuf()->sputbackc(c)\fP\&.

.PP
If \fRrdbuf()\fP is null or if \fRsputbackc()\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 \fRgcount()\fP will return 0, as required by DR 60\&. 
.RE
.PP

.PP
References \fBstd::ios_base::badbit\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::basic_streambuf< _CharT, _Traits >::sputbackc()\fP\&.
.PP
Referenced by \fBstd::operator<<()\fP\&.
.SS "void *& std::ios_base::pword (int __ix)\fR [inline]\fP, \fR [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<typename _CharT , typename _Traits > \fBbasic_streambuf\fP< _CharT, _Traits > * \fBstd::basic_ios\fP< _CharT, _Traits >::rdbuf (\fBbasic_streambuf\fP< _CharT, _Traits > * __sb)\fR [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 \fRrdbuf()\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<typename _CharT , typename _Traits , typename _Alloc > __stringbuf_type * \fBstd::basic_istringstream\fP< _CharT, _Traits, _Alloc >::rdbuf () const\fR [inline]\fP"

.PP
Accessing the underlying buffer\&. 
.PP
\fBReturns\fP
.RS 4
The current basic_stringbuf buffer\&.
.RE
.PP
This hides both signatures of std::basic_ios::rdbuf()\&. 
.SS "template<typename _CharT , typename _Traits > \fBiostate\fP \fBstd::basic_ios\fP< _CharT, _Traits >::rdstate () const\fR [inline]\fP, \fR [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, and \fBstd::basic_ios< _CharT, _Traits >::setstate()\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::read (char_type * __s, \fBstreamsize\fP __n)\fR [inherited]\fP"

.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 \fRgood()\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 \fRfailbit|eofbit\fP\&.
.PP

.PP
\fBNote\fP
.RS 4
This function is not overloaded on signed char and unsigned char\&. 
.RE
.PP

.PP
References \fBstd::ios_base::badbit\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::failbit\fP, and \fBstd::ios_base::goodbit\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBstreamsize\fP \fBstd::basic_istream\fP< _CharT, _Traits >::readsome (char_type * __s, \fBstreamsize\fP __n)\fR [inherited]\fP"

.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, \fRrdbuf()->in_avail()\fP, called \fRA\fP here:
.IP "\(bu" 2
if \fRA\fP \fR==\fP \fR-1\fP, sets eofbit and extracts no characters
.IP "\(bu" 2
if \fRA\fP \fR==\fP \fR0\fP, extracts no characters
.IP "\(bu" 2
if \fRA\fP \fR>\fP \fR0\fP, extracts \fRmin(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::ios_base::badbit\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::min()\fP\&.
.SS "void std::ios_base::register_callback (\fBevent_callback\fP __fn, int __index)\fR [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<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::seekg (off_type __off, \fBios_base::seekdir\fP __dir)\fR [inherited]\fP"

.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 \fRfail()\fP is not true, calls \fRrdbuf()->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 \fRgcount()\fP\&. 
.RE
.PP

.PP
References \fBstd::ios_base::badbit\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::failbit\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::ios_base::in\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::seekg (pos_type __pos)\fR [inherited]\fP"

.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 \fRfail()\fP is not true, calls \fRrdbuf()->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 \fRgcount()\fP\&. 
.RE
.PP

.PP
References \fBstd::ios_base::badbit\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::failbit\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::ios_base::in\fP\&.
.SS "\fBfmtflags\fP std::ios_base::setf (\fBfmtflags\fP __fmtfl)\fR [inline]\fP, \fR [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\&. 
.PP
Referenced by \fBstd::__detail::operator>>()\fP\&.
.SS "\fBfmtflags\fP std::ios_base::setf (\fBfmtflags\fP __fmtfl, \fBfmtflags\fP __mask)\fR [inline]\fP, \fR [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 \fR&\fP \fImask\fP\&. An example mask is \fRios_base::adjustfield\fP\&. 
.SS "template<typename _CharT , typename _Traits > void \fBstd::basic_ios\fP< _CharT, _Traits >::setstate (\fBiostate\fP __state)\fR [inline]\fP, \fR [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 >::sentry::sentry()\fP, \fBstd::basic_ostream< _CharT, _Traits >::sentry::~sentry()\fP, \fBstd::basic_fstream< _CharT, _Traits >::close()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::close()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::close()\fP, \fBstd::basic_ostream< _CharT, _Traits >::flush()\fP, \fBstd::getline()\fP, \fBstd::getline()\fP, \fBstd::basic_fstream< _CharT, _Traits >::open()\fP, \fBstd::basic_fstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ostream< _CharT, _Traits >::operator<<()\fP, \fBstd::operator<<()\fP, \fBstd::operator<<()\fP, \fBstd::operator>>()\fP, \fBstd::operator>>()\fP, \fBstd::operator>>()\fP, \fBstd::tr2::operator>>()\fP, \fBstd::basic_ostream< _CharT, _Traits >::put()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, \fBstd::basic_ostream< _CharT, _Traits >::seekp()\fP, and \fBstd::ws()\fP\&.
.SS "template<typename _CharT , typename _Traits , typename _Alloc > \fB__string_type\fP \fBstd::basic_istringstream\fP< _CharT, _Traits, _Alloc >::str () const &\fR [inline]\fP"

.PP
Copying out the string buffer\&. 
.PP
\fBReturns\fP
.RS 4
\fRrdbuf()->str()\fP 
.RE
.PP

.SS "template<typename _CharT , typename _Traits , typename _Alloc > void \fBstd::basic_istringstream\fP< _CharT, _Traits, _Alloc >::str (const \fB__string_type\fP & __s)\fR [inline]\fP"

.PP
Setting a new buffer\&. 
.PP
\fBParameters\fP
.RS 4
\fI__s\fP The string to use as a new sequence\&.
.RE
.PP
Calls \fRrdbuf()->str(s)\fP\&. 
.SS "template<typename _CharT , typename _Traits > int \fBstd::basic_istream\fP< _CharT, _Traits >::sync (void )\fR [inherited]\fP"

.PP
Synchronizing the stream buffer\&. 
.PP
\fBReturns\fP
.RS 4
0 on success, -1 on failure
.RE
.PP
If \fRrdbuf()\fP is a null pointer, returns -1\&.

.PP
Otherwise, calls \fRrdbuf()->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 \fRgcount()\fP\&. 
.RE
.PP

.PP
References \fBstd::ios_base::badbit\fP, \fBstd::ios_base::goodbit\fP, and \fBstd::basic_streambuf< _CharT, _Traits >::pubsync()\fP\&.
.SS "static bool std::ios_base::sync_with_stdio (bool __sync = \fRtrue\fP)\fR [static]\fP, \fR [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<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits >::pos_type \fBstd::basic_istream\fP< _CharT, _Traits >::tellg (void )\fR [inherited]\fP"

.PP
Getting the current read position\&. 
.PP
\fBReturns\fP
.RS 4
A file position object\&.
.RE
.PP
If \fRfail()\fP is not false, returns \fRpos_type\fP(-1) to indicate failure\&. Otherwise returns \fRrdbuf()->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 \fRgcount()\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, and \fBstd::ios_base::in\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_ostream\fP< _CharT, _Traits > * \fBstd::basic_ios\fP< _CharT, _Traits >::tie () const\fR [inline]\fP, \fR [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, \fRstd::cin\fP is tied to \fRstd::cout\fP\&. 
.PP
Referenced by \fBstd::basic_ostream< _CharT, _Traits >::sentry::sentry()\fP, and \fBstd::basic_ios< _CharT, _Traits >::copyfmt()\fP\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_ostream\fP< _CharT, _Traits > * \fBstd::basic_ios\fP< _CharT, _Traits >::tie (\fBbasic_ostream\fP< _CharT, _Traits > * __tiestr)\fR [inline]\fP, \fR [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<typename _CharT , typename _Traits > \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::unget (void )\fR [inherited]\fP"

.PP
Unextracting the previous character\&. 
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
If \fRrdbuf()\fP is not null, calls \fRrdbuf()->sungetc(c)\fP\&.

.PP
If \fRrdbuf()\fP is null or if \fRsungetc()\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 \fRgcount()\fP will return 0, as required by DR 60\&. 
.RE
.PP

.PP
References \fBstd::ios_base::eofbit\fP, and \fBstd::ios_base::goodbit\fP\&.
.PP
Referenced by \fBstd::__detail::operator>>()\fP\&.
.SS "void std::ios_base::unsetf (\fBfmtflags\fP __mask)\fR [inline]\fP, \fR [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<typename _CharT , typename _Traits > char_type \fBstd::basic_ios\fP< _CharT, _Traits >::widen (char __c) const\fR [inline]\fP, \fR [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 \fRchar\fP to a character of \fRchar_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::endl()\fP, \fBstd::basic_ios< _CharT, _Traits >::fill()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::getline()\fP, \fBstd::getline()\fP, \fBstd::getline()\fP, \fBstd::operator<<()\fP, \fBstd::operator<<()\fP, and \fBstd::tr2::operator>>()\fP\&.
.SS "\fBstreamsize\fP std::ios_base::width () const\fR [inline]\fP, \fR [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\&. 
.PP
Referenced by \fBstd::basic_ios< _CharT, _Traits >::copyfmt()\fP, \fBstd::num_put< _CharT, _OutIter >::do_put()\fP, \fBstd::operator>>()\fP, and \fBstd::operator>>()\fP\&.
.SS "\fBstreamsize\fP std::ios_base::width (\fBstreamsize\fP __wide)\fR [inline]\fP, \fR [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 "static int std::ios_base::xalloc ()\fR [static]\fP, \fR [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<typename _CharT , typename _Traits > \fBstreamsize\fP \fBstd::basic_istream\fP< _CharT, _Traits >::_M_gcount\fR [protected]\fP, \fR [inherited]\fP"
The number of characters extracted in the previous unformatted function; see gcount()\&. 
.PP
Referenced by \fBstd::basic_istream< _CharT, _Traits >::~basic_istream()\fP, and \fBstd::basic_istream< _CharT, _Traits >::gcount()\fP\&.
.SS "const \fBfmtflags\fP std::ios_base::adjustfield\fR [static]\fP, \fR [inherited]\fP"

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

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

.PP
Open and seek to end immediately after opening\&. 
.PP
Referenced by \fBstd::basic_filebuf< _CharT, _Traits >::open()\fP\&.
.SS "const \fBiostate\fP std::ios_base::badbit\fR [static]\fP, \fR [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_ostream< _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< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, char_traits< _CharT > >::get()\fP, \fBstd::basic_ostream< _CharT, _Traits >::operator<<()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::operator>>()\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_istream< _CharT, char_traits< _CharT > >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::sync()\fP, \fBstd::basic_istream< _CharT, _Traits >::tellg()\fP, \fBstd::basic_istream< _CharT, char_traits< _CharT > >::tellg()\fP, and \fBstd::ws()\fP\&.
.SS "const \fBfmtflags\fP std::ios_base::basefield\fR [static]\fP, \fR [inherited]\fP"

.PP
A mask of dec|oct|hex\&. Useful for the 2-arg form of \fRsetf\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 "const \fBseekdir\fP std::ios_base::beg\fR [static]\fP, \fR [inherited]\fP"

.PP
Request a seek relative to the beginning of the stream\&. 
.PP
Referenced by \fBstd::basic_filebuf< _CharT, _Traits >::seekpos()\fP\&.
.SS "const \fBopenmode\fP std::ios_base::binary\fR [static]\fP, \fR [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 "const \fBfmtflags\fP std::ios_base::boolalpha\fR [static]\fP, \fR [inherited]\fP"

.PP
Insert/extract \fRbool\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 "const \fBseekdir\fP std::ios_base::cur\fR [static]\fP, \fR [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 "const \fBfmtflags\fP std::ios_base::dec\fR [static]\fP, \fR [inherited]\fP"

.PP
Converts integer input or generates integer output in decimal base\&. 
.PP
Referenced by \fBstd::dec()\fP\&.
.SS "const \fBseekdir\fP std::ios_base::end\fR [static]\fP, \fR [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 "const \fBiostate\fP std::ios_base::eofbit\fR [static]\fP, \fR [inherited]\fP"

.PP
Indicates that an input operation reached the end of an input sequence\&. 
.PP
Referenced by \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()\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::basic_istream< _CharT, char_traits< _CharT > >::get()\fP, \fBstd::time_get< _CharT, _InIter >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::ignore()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::operator>>()\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_istream< _CharT, char_traits< _CharT > >::sync()\fP, \fBstd::basic_istream< _CharT, _Traits >::unget()\fP, and \fBstd::ws()\fP\&.
.SS "const \fBiostate\fP std::ios_base::failbit\fR [static]\fP, \fR [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_ostream< _CharT, _Traits >::sentry::sentry()\fP, \fBstd::basic_fstream< _CharT, _Traits >::close()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::close()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::close()\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::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, _Traits >::get()\fP, \fBstd::basic_istream< _CharT, char_traits< _CharT > >::get()\fP, \fBstd::time_get< _CharT, _InIter >::get()\fP, \fBstd::basic_fstream< _CharT, _Traits >::open()\fP, \fBstd::basic_fstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::open()\fP, \fBstd::operator<<()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::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 "const \fBfmtflags\fP std::ios_base::fixed\fR [static]\fP, \fR [inherited]\fP"

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

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

.PP
Indicates all is well\&. 
.PP
Referenced by \fBstd::basic_istream< _CharT, _Traits >::sentry::sentry()\fP, \fBstd::num_get< _CharT, _InIter >::do_get()\fP, \fBstd::time_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, istreambuf_iterator< _CharT > >::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::basic_istream< _CharT, char_traits< _CharT > >::get()\fP, \fBstd::time_get< _CharT, _InIter >::get()\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::basic_istream< _CharT, _Traits >::operator>>()\fP, \fBstd::operator>>()\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, char_traits< _CharT > >::readsome()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::seekg()\fP, \fBstd::basic_istream< _CharT, _Traits >::sync()\fP, \fBstd::basic_istream< _CharT, _Traits >::unget()\fP, and \fBstd::ws()\fP\&.
.SS "const \fBfmtflags\fP std::ios_base::hex\fR [static]\fP, \fR [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 "const \fBopenmode\fP std::ios_base::in\fR [static]\fP, \fR [inherited]\fP"

.PP
Open for input\&. Default for \fRifstream\fP and fstream\&. 
.PP
Referenced by \fBstd::basic_filebuf< _CharT, _Traits >::_M_set_buffer()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ifstream< _CharT, _Traits >::open()\fP, \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_stringbuf< _CharT, _Traits, _Alloc >::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 "const \fBfmtflags\fP std::ios_base::internal\fR [static]\fP, \fR [inherited]\fP"

.PP
Adds fill characters at a designated internal point in certain generated output, or identical to \fRright\fP if no such point is designated\&. 
.PP
Referenced by \fBstd::internal()\fP\&.
.SS "const \fBfmtflags\fP std::ios_base::left\fR [static]\fP, \fR [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 "const \fBfmtflags\fP std::ios_base::oct\fR [static]\fP, \fR [inherited]\fP"

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

.PP
Open for output\&. Default for \fRofstream\fP and fstream\&. 
.PP
Referenced by \fBstd::basic_filebuf< _CharT, _Traits >::_M_set_buffer()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::open()\fP, \fBstd::basic_ofstream< _CharT, _Traits >::open()\fP, \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 "const \fBfmtflags\fP std::ios_base::right\fR [static]\fP, \fR [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 "const \fBfmtflags\fP std::ios_base::scientific\fR [static]\fP, \fR [inherited]\fP"

.PP
Generates floating-point output in scientific notation\&. 
.PP
Referenced by \fBstd::hexfloat()\fP, and \fBstd::scientific()\fP\&.
.SS "const \fBfmtflags\fP std::ios_base::showbase\fR [static]\fP, \fR [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 "const \fBfmtflags\fP std::ios_base::showpoint\fR [static]\fP, \fR [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 "const \fBfmtflags\fP std::ios_base::showpos\fR [static]\fP, \fR [inherited]\fP"

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

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

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

.PP
Flushes output after each output operation\&. 
.PP
Referenced by \fBstd::basic_ostream< _CharT, _Traits >::sentry::~sentry()\fP, \fBstd::nounitbuf()\fP, and \fBstd::unitbuf()\fP\&.
.SS "const \fBfmtflags\fP std::ios_base::uppercase\fR [static]\fP, \fR [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\&.