.TH "std::basic_ostringstream< _CharT, _Traits, _Alloc >" 3cxx "Fri May 28 2021" "libstdc++" \" -*- nroff -*-
.ad l
.nh
.SH NAME
std::basic_ostringstream< _CharT, _Traits, _Alloc > \- Controlling output for std::string\&.  

.SH SYNOPSIS
.br
.PP
.PP
Inherits \fBstd::basic_ostream< _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 \fBnum_put\fP< _CharT, \fBostreambuf_iterator\fP< _CharT, _Traits > > \fB__num_put_type\fP"
.br
.ti -1c
.RI "typedef \fBbasic_ostream\fP< char_type, traits_type > \fB__ostream_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 int io_state \fB_GLIBCXX_DEPRECATED_SUGGEST\fP('std::iostate')"
.br
.ti -1c
.RI "typedef int open_mode \fB_GLIBCXX_DEPRECATED_SUGGEST\fP('std::openmode')"
.br
.ti -1c
.RI "typedef int seek_dir \fB_GLIBCXX_DEPRECATED_SUGGEST\fP('std::seekdir')"
.br
.ti -1c
.RI "typedef \fBstd::streamoff\fP \fBstreamoff\fP \fB_GLIBCXX_DEPRECATED_SUGGEST\fP('std::streamoff')"
.br
.ti -1c
.RI "typedef \fBstd::streampos\fP \fBstreampos\fP \fB_GLIBCXX_DEPRECATED_SUGGEST\fP('std::streampos')"
.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 _Ios_Fmtflags \fBfmtflags\fP"
.br
.RI "This is a bitmask type\&. "
.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_get\fP< _CharT, \fBistreambuf_iterator\fP< _CharT, _Traits > > \fB__num_get_type\fP"
.br
.in -1c
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBbasic_ostringstream\fP ()"
.br
.RI "Default constructor starts with an empty string buffer\&. "
.ti -1c
.RI "\fBbasic_ostringstream\fP (\fBbasic_ostringstream\fP &&__rhs)"
.br
.ti -1c
.RI "\fBbasic_ostringstream\fP (const \fB__string_type\fP &__str, \fBios_base::openmode\fP __mode=\fBios_base::out\fP)"
.br
.RI "Starts with an existing string buffer\&. "
.ti -1c
.RI "\fBbasic_ostringstream\fP (const \fBbasic_ostringstream\fP &)=delete"
.br
.ti -1c
.RI "\fBbasic_ostringstream\fP (\fBios_base::openmode\fP __mode)"
.br
.RI "Starts with an empty string buffer\&. "
.ti -1c
.RI "\fB~basic_ostringstream\fP ()"
.br
.RI "The destructor does nothing\&. "
.ti -1c
.RI "const \fBlocale\fP & \fB_M_getloc\fP () const"
.br
.RI "Locale access\&. "
.ti -1c
.RI "template<typename _ValueT > \fBbasic_ostream\fP< _CharT, _Traits > & \fB_M_insert\fP (_ValueT __v)"
.br
.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 "\fB__ostream_type\fP & \fBflush\fP ()"
.br
.RI "Synchronizing the stream buffer\&. "
.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 "\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 "\fB__ostream_type\fP & \fBoperator<<\fP (\fB__streambuf_type\fP *__sb)"
.br
.RI "Extracting from another streambuf\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (const void *__p)"
.br
.RI "Pointer arithmetic inserters\&. "
.ti -1c
.RI "\fBbasic_ostringstream\fP & \fBoperator=\fP (\fBbasic_ostringstream\fP &&__rhs)"
.br
.ti -1c
.RI "\fBbasic_ostringstream\fP & \fBoperator=\fP (const \fBbasic_ostringstream\fP &)=delete"
.br
.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 "__stringbuf_type * \fBrdbuf\fP () const"
.br
.RI "Accessing the underlying buffer\&. "
.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 "\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 "\fB__ostream_type\fP & \fBseekp\fP (off_type, \fBios_base::seekdir\fP)"
.br
.RI "Changing the current write position\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBseekp\fP (pos_type)"
.br
.RI "Changing the current write position\&. "
.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 () const"
.br
.RI "Copying out the string buffer\&. "
.ti -1c
.RI "void \fBstr\fP (const \fB__string_type\fP &__s)"
.br
.RI "Setting a new buffer\&. "
.ti -1c
.RI "void \fBswap\fP (\fBbasic_ostringstream\fP &__rhs)"
.br
.ti -1c
.RI "pos_type \fBtellp\fP ()"
.br
.RI "Getting the current write position\&. "
.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 "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__ostream_type\fP & \fBoperator<<\fP (\fB__ostream_type\fP &(*__pf)(\fB__ostream_type\fP &))"
.br
.RI "Interface for manipulators\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (\fB__ios_type\fP &(*__pf)(\fB__ios_type\fP &))"
.br
.RI "Interface for manipulators\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (\fBios_base\fP &(*__pf)(\fBios_base\fP &))"
.br
.RI "Interface for manipulators\&. "
.in -1c
.in -1c
.PP
.RI "\fBInserters\fP"
.br
All the \fCoperator<<\fP functions (aka \fIformatted output functions\fP) have some common behavior\&. Each starts by constructing a temporary object of type std::basic_ostream::sentry\&. This can have 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 generate whatever data is appropriate for the type of the argument\&.
.PP
If an exception is thrown during insertion, ios_base::badbit will be turned on in the stream's error state without causing an ios_base::failure to be thrown\&. The original exception will then be rethrown\&. 
.PP
.in +1c
.in +1c
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (long __n)"
.br
.RI "Integer arithmetic inserters\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (unsigned long __n)"
.br
.RI "Integer arithmetic inserters\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (bool __n)"
.br
.RI "Integer arithmetic inserters\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (short __n)"
.br
.RI "Integer arithmetic inserters\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (unsigned short __n)"
.br
.RI "Integer arithmetic inserters\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (int __n)"
.br
.RI "Integer arithmetic inserters\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (unsigned int __n)"
.br
.RI "Integer arithmetic inserters\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (long long __n)"
.br
.RI "Integer arithmetic inserters\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (unsigned long long __n)"
.br
.RI "Integer arithmetic inserters\&. "
.in -1c
.in -1c
.PP
.RI "\fB\fP"
.br

.in +1c
.in +1c
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (double __f)"
.br
.RI "Floating point arithmetic inserters\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (float __f)"
.br
.RI "Floating point arithmetic inserters\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBoperator<<\fP (long double __f)"
.br
.RI "Floating point arithmetic inserters\&. "
.in -1c
.in -1c
.PP
.RI "\fBUnformatted Output Functions\fP"
.br
All the unformatted output functions have some common behavior\&. Each starts by constructing a temporary object of type std::basic_ostream::sentry\&. 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 generate whatever data is appropriate for the type of the argument\&.
.PP
If an exception is thrown during insertion, ios_base::badbit will be turned on in the stream's error state\&. If badbit is on in the stream's exceptions mask, the exception will be rethrown without completing its actions\&. 
.PP
.in +1c
.in +1c
.ti -1c
.RI "\fB__ostream_type\fP & \fBput\fP (char_type __c)"
.br
.RI "Simple insertion\&. "
.ti -1c
.RI "void \fB_M_write\fP (const char_type *__s, \fBstreamsize\fP __n)"
.br
.RI "Core write functionality, without sentry\&. "
.ti -1c
.RI "\fB__ostream_type\fP & \fBwrite\fP (const char_type *__s, \fBstreamsize\fP __n)"
.br
.RI "Character string insertion\&. "
.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 \fBfmtflags\fP \fBadjustfield\fP"
.br
.RI "A mask of left|right|internal\&. Useful for the 2-arg form of \fCsetf\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 \fCsetf\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 \fCbool\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 \fCsetf\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 \fCifstream\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 \fCright\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 \fCofstream\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 \fCofstream\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 "_Words & \fB_M_grow_words\fP (int __index, bool __iword)"
.br
.ti -1c
.RI "void \fB_M_init\fP ()  throw ()"
.br
.ti -1c
.RI "template<typename _ValueT > \fB__ostream_type\fP & \fB_M_insert\fP (_ValueT __v)"
.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_ostream\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 "\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_ostringstream< _CharT, _Traits, _Alloc >"
Controlling output 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 writing to objects of type std::basic_string, using the inherited functions from std::basic_ostream\&. To control the associated sequence, an instance of std::basic_stringbuf is used, which this page refers to as \fCsb\fP\&. 
.PP
Definition at line 550 of file sstream\&.
.SH "Member Typedef Documentation"
.PP 
.SS "template<typename _CharT , typename _Traits > typedef \fBnum_get\fP<_CharT, \fBistreambuf_iterator\fP<_CharT, _Traits> > \fBstd::basic_ios\fP< _CharT, _Traits >::\fB__num_get_type\fP\fC [inherited]\fP"
These are non-standard types\&. 
.PP
Definition at line 91 of file basic_ios\&.h\&.
.SS "typedef void(* std::ios_base::event_callback) (\fBevent\fP __e, \fBios_base\fP &__b, int __i)\fC [inherited]\fP"

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

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

.PP
Definition at line 323 of file ios_base\&.h\&.
.SS "typedef _Ios_Iostate std::ios_base::iostate\fC [inherited]\fP"

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

.PP
Definition at line 398 of file ios_base\&.h\&.
.SS "typedef _Ios_Openmode std::ios_base::openmode\fC [inherited]\fP"

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

.PP
Definition at line 429 of file ios_base\&.h\&.
.SS "typedef _Ios_Seekdir std::ios_base::seekdir\fC [inherited]\fP"

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

.PP
Definition at line 461 of file ios_base\&.h\&.
.SH "Member Enumeration Documentation"
.PP 
.SS "enum \fBstd::ios_base::event\fP\fC [inherited]\fP"

.PP
The set of events that may be passed to an event callback\&. erase_event is used during ~ios() and copyfmt()\&. imbue_event is used during imbue()\&. copyfmt_event is used during copyfmt()\&. 
.PP
Definition at line 494 of file ios_base\&.h\&.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "template<typename _CharT , typename _Traits , typename _Alloc > \fBstd::basic_ostringstream\fP< _CharT, _Traits, _Alloc >::\fBbasic_ostringstream\fP ()\fC [inline]\fP"

.PP
Default constructor starts with an empty string buffer\&. Initializes \fCsb\fP using \fCmode|out\fP, and passes \fC&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
Definition at line 583 of file sstream\&.
.SS "template<typename _CharT , typename _Traits , typename _Alloc > \fBstd::basic_ostringstream\fP< _CharT, _Traits, _Alloc >::\fBbasic_ostringstream\fP (\fBios_base::openmode\fP __mode)\fC [inline]\fP, \fC [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
\fCios_base::out\fP is automatically included in \fImode\fP\&.
.PP
Initializes \fCsb\fP using \fCmode|out\fP, and passes \fC&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
Definition at line 600 of file sstream\&.
.SS "template<typename _CharT , typename _Traits , typename _Alloc > \fBstd::basic_ostringstream\fP< _CharT, _Traits, _Alloc >::\fBbasic_ostringstream\fP (const \fB__string_type\fP & __str, \fBios_base::openmode\fP __mode = \fC\fBios_base::out\fP\fP)\fC [inline]\fP, \fC [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
\fCios_base::out\fP is automatically included in \fImode\fP\&.
.PP
Initializes \fCsb\fP using \fIstr\fP and \fCmode|out\fP, and passes \fC&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
Definition at line 618 of file sstream\&.
.SS "template<typename _CharT , typename _Traits , typename _Alloc > \fBstd::basic_ostringstream\fP< _CharT, _Traits, _Alloc >::~\fBbasic_ostringstream\fP ()\fC [inline]\fP"

.PP
The destructor does nothing\&. The buffer is deallocated by the stringbuf object, not the formatting stream\&. 
.PP
Definition at line 629 of file sstream\&.
.SH "Member Function Documentation"
.PP 
.SS "const \fBlocale\fP& std::ios_base::_M_getloc () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Locale access\&. 
.PP
\fBReturns\fP
.RS 4
A reference to the current locale\&.
.RE
.PP
Like getloc above, but returns a reference instead of generating a copy\&. 
.PP
Definition at line 786 of file ios_base\&.h\&.
.PP
Referenced by std::money_get< _CharT, _InIter >::do_get(), std::time_get< _CharT, _InIter >::do_get(), std::num_get< _CharT, _InIter >::do_get(), std::time_get< _CharT, _InIter >::do_get_date(), std::time_get< _CharT, _InIter >::do_get_monthname(), std::time_get< _CharT, _InIter >::do_get_time(), std::time_get< _CharT, _InIter >::do_get_weekday(), std::num_put< _CharT, _OutIter >::do_put(), std::time_put< _CharT, _OutIter >::do_put(), std::time_get< _CharT, _InIter >::get(), and std::time_put< _CharT, _OutIter >::put()\&.
.SS "template<typename _CharT , typename _Traits > void \fBstd::basic_ostream\fP< _CharT, _Traits >::_M_write (const char_type * __s, \fBstreamsize\fP __n)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Core write functionality, without sentry\&. 
.PP
\fBParameters\fP
.RS 4
\fI__s\fP The array to insert\&. 
.br
\fI__n\fP Maximum number of characters to insert\&. 
.RE
.PP

.PP
Definition at line 317 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > bool \fBstd::basic_ios\fP< _CharT, _Traits >::bad () const\fC [inline]\fP, \fC [inherited]\fP"

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

.PP
[Re]sets the error state\&. 
.PP
\fBParameters\fP
.RS 4
\fI__state\fP The new state flag(s) to set\&.
.RE
.PP
See std::ios_base::iostate for the possible bit values\&. Most users will not need to pass an argument\&. 
.PP
Definition at line 41 of file basic_ios\&.tcc\&.
.PP
Referenced by std::basic_ios< _CharT, _Traits >::exceptions(), std::__detail::operator>>(), std::basic_istream< _CharT, _Traits >::seekg(), std::basic_ios< _CharT, _Traits >::setstate(), and std::basic_istream< _CharT, _Traits >::unget()\&.
.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)\fC [inherited]\fP"

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

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

.PP
Throwing exceptions on errors\&. 
.PP
\fBReturns\fP
.RS 4
The current exceptions mask\&.
.RE
.PP
This changes nothing in the stream\&. See the one-argument version of exceptions(iostate) for the meaning of the return value\&. 
.PP
Definition at line 222 of file basic_ios\&.h\&.
.PP
Referenced by std::basic_ios< _CharT, _Traits >::copyfmt()\&.
.SS "template<typename _CharT , typename _Traits > void \fBstd::basic_ios\fP< _CharT, _Traits >::exceptions (\fBiostate\fP __except)\fC [inline]\fP, \fC [inherited]\fP"

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

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

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

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

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

.fi
.PP
 
.PP
Definition at line 257 of file basic_ios\&.h\&.
.PP
References std::basic_ios< _CharT, _Traits >::clear()\&.
.SS "template<typename _CharT , typename _Traits > bool \fBstd::basic_ios\fP< _CharT, _Traits >::fail () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Fast error checking\&. 
.PP
\fBReturns\fP
.RS 4
True if either the badbit or the failbit is set\&.
.RE
.PP
Checking the badbit in fail() is historical practice\&. Note that other iostate flags may also be set\&. 
.PP
Definition at line 201 of file basic_ios\&.h\&.
.PP
References std::ios_base::badbit, std::ios_base::failbit, and std::basic_ios< _CharT, _Traits >::rdstate()\&.
.PP
Referenced by std::basic_ios< _CharT, _Traits >::operator bool(), std::basic_ios< _CharT, _Traits >::operator!(), and std::regex_traits< _Ch_type >::value()\&.
.SS "template<typename _CharT , typename _Traits > char_type \fBstd::basic_ios\fP< _CharT, _Traits >::fill () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Retrieves the \fIempty\fP character\&. 
.PP
\fBReturns\fP
.RS 4
The current fill character\&.
.RE
.PP
It defaults to a space (' ') in the current locale\&. 
.PP
Definition at line 370 of file basic_ios\&.h\&.
.PP
References std::basic_ios< _CharT, _Traits >::widen()\&.
.PP
Referenced by std::basic_ios< _CharT, _Traits >::copyfmt(), std::basic_ios< _CharT, _Traits >::fill(), and std::gamma_distribution< double >::operator()()\&.
.SS "template<typename _CharT , typename _Traits > char_type \fBstd::basic_ios\fP< _CharT, _Traits >::fill (\fBchar_type\fP __ch)\fC [inline]\fP, \fC [inherited]\fP"

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

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

.PP
Definition at line 631 of file ios_base\&.h\&.
.PP
Referenced by std::basic_ios< _CharT, _Traits >::copyfmt(), std::num_get< _CharT, _InIter >::do_get(), std::num_put< _CharT, _OutIter >::do_put(), std::gamma_distribution< double >::operator()(), std::operator<<(), std::operator>>(), and std::__detail::operator>>()\&.
.SS "\fBfmtflags\fP std::ios_base::flags (\fBfmtflags\fP __fmtfl)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Setting new format flags all at once\&. 
.PP
\fBParameters\fP
.RS 4
\fI__fmtfl\fP The new flags to set\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The previous format control flags\&.
.RE
.PP
This function overwrites all the format flags with \fI__fmtfl\fP\&. 
.PP
Definition at line 642 of file ios_base\&.h\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_ostream\fP< _CharT, _Traits > & \fBstd::basic_ostream\fP< _CharT, _Traits >::flush\fC [inherited]\fP"

.PP
Synchronizing the stream buffer\&. 
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
If \fCrdbuf()\fP is a null pointer, changes nothing\&.
.PP
Otherwise, calls \fCrdbuf()->pubsync()\fP, and if that returns -1, sets badbit\&. 
.PP
Definition at line 210 of file ostream\&.tcc\&.
.PP
References std::ios_base::goodbit\&.
.SS "\fBlocale\fP std::ios_base::getloc () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Locale access\&. 
.PP
\fBReturns\fP
.RS 4
A copy of the current locale\&.
.RE
.PP
If \fCimbue(loc)\fP has previously been called, then this function returns \fCloc\fP\&. Otherwise, it returns a copy of \fCstd::locale()\fP, the global C++ locale\&. 
.PP
Definition at line 775 of file ios_base\&.h\&.
.PP
Referenced by std::basic_ios< _CharT, _Traits >::copyfmt(), std::money_put< _CharT, _OutIter >::do_put(), and std::ws()\&.
.SS "template<typename _CharT , typename _Traits > bool \fBstd::basic_ios\fP< _CharT, _Traits >::good () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Fast error checking\&. 
.PP
\fBReturns\fP
.RS 4
True if no error flags are set\&.
.RE
.PP
A wrapper around rdstate\&. 
.PP
Definition at line 180 of file basic_ios\&.h\&.
.PP
References std::basic_ios< _CharT, _Traits >::rdstate()\&.
.PP
Referenced by std::basic_istream< _CharT, _Traits >::sentry::sentry(), std::basic_ostream< _CharT, _Traits >::sentry::sentry(), and std::__detail::operator>>()\&.
.SS "template<typename _CharT , typename _Traits > \fBlocale\fP \fBstd::basic_ios\fP< _CharT, _Traits >::imbue (const \fBlocale\fP & __loc)\fC [inherited]\fP"

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

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

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

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

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

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

.PP
The quick-and-easy status check\&. This allows you to write constructs such as \fCif (!a_stream) \&.\&.\&.\fP and \fCwhile (a_stream) \&.\&.\&.\fP 
.PP
Definition at line 125 of file basic_ios\&.h\&.
.PP
References std::basic_ios< _CharT, _Traits >::fail()\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (\fB__ios_type\fP &(*)(\fB__ios_type\fP &) __pf)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Interface for manipulators\&. Manipulators such as \fCstd::endl\fP and \fCstd::hex\fP use these functions in constructs like 'std::cout << std::endl'\&. For more information, see the iomanip header\&. 
.PP
Definition at line 116 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (\fB__ostream_type\fP &(*)(\fB__ostream_type\fP &) __pf)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Interface for manipulators\&. Manipulators such as \fCstd::endl\fP and \fCstd::hex\fP use these functions in constructs like 'std::cout << std::endl'\&. For more information, see the iomanip header\&. 
.PP
Definition at line 107 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_ostream\fP< _CharT, _Traits > & \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (\fB__streambuf_type\fP * __sb)\fC [inherited]\fP"

.PP
Extracting from another streambuf\&. 
.PP
\fBParameters\fP
.RS 4
\fI__sb\fP A pointer to a streambuf
.RE
.PP
This function behaves like one of the basic arithmetic extractors, in that it also constructs a sentry object and has the same error handling behavior\&.
.PP
If \fC__sb\fP is NULL, the stream will set failbit in its error state\&.
.PP
Characters are extracted from \fC__sb\fP and inserted into \fC*this\fP until one of the following occurs:
.PP
.IP "\(bu" 2
the input stream reaches end-of-file,
.IP "\(bu" 2
insertion into the output sequence fails (in this case, the character that would have been inserted is not extracted), or
.IP "\(bu" 2
an exception occurs while getting a character from \fC__sb\fP, which sets failbit in the error state
.PP
.PP
If the function inserts no characters, failbit is set\&. 
.PP
Definition at line 63 of file ostream\&.tcc\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (bool __n)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Integer arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 173 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (const void * __p)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Pointer arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__p\fP A variable of pointer type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 244 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (double __f)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Floating point arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__f\fP A variable of builtin floating point type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 219 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (float __f)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Floating point arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__f\fP A variable of builtin floating point type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 223 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_ostream\fP< _CharT, _Traits > & \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (int __n)\fC [inherited]\fP"

.PP
Integer arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 63 of file ostream\&.tcc\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (\fBios_base\fP &(*)(\fBios_base\fP &) __pf)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Interface for manipulators\&. Manipulators such as \fCstd::endl\fP and \fCstd::hex\fP use these functions in constructs like 'std::cout << std::endl'\&. For more information, see the iomanip header\&. 
.PP
Definition at line 126 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (long __n)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Integer arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 165 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (long double __f)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Floating point arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__f\fP A variable of builtin floating point type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 231 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (long long __n)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Integer arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 200 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_ostream\fP< _CharT, _Traits > & \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (short __n)\fC [inherited]\fP"

.PP
Integer arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 63 of file ostream\&.tcc\&.
.PP
References std::ios_base::goodbit\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (unsigned int __n)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Integer arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 191 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (unsigned long __n)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Integer arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 169 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (unsigned long long __n)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Integer arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 204 of file ostream\&.
.SS "template<typename _CharT , typename _Traits > \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (unsigned short __n)\fC [inline]\fP, \fC [inherited]\fP"

.PP
Integer arithmetic inserters\&. 
.PP
\fBParameters\fP
.RS 4
\fI__n\fP A variable of builtin integral type\&. 
.RE
.PP
\fBReturns\fP
.RS 4
\fC*this\fP if successful
.RE
.PP
These functions use the stream's current locale (specifically, the \fCnum_get\fP facet) to perform numeric formatting\&. 
.PP
Definition at line 180 of file ostream\&.
.SS "\fBstreamsize\fP std::ios_base::precision () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Flags access\&. 
.PP
\fBReturns\fP
.RS 4
The precision to generate on certain output operations\&.
.RE
.PP
Be careful if you try to give a definition of \fIprecision\fP here; see DR 189\&. 
.PP
Definition at line 701 of file ios_base\&.h\&.
.PP
Referenced by std::basic_ios< _CharT, _Traits >::copyfmt(), and std::gamma_distribution< double >::operator()()\&.
.SS "\fBstreamsize\fP std::ios_base::precision (\fBstreamsize\fP __prec)\fC [inline]\fP, \fC [inherited]\fP"

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

.PP
Definition at line 710 of file ios_base\&.h\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_ostream\fP< _CharT, _Traits > & \fBstd::basic_ostream\fP< _CharT, _Traits >::put (char_type __c)\fC [inherited]\fP"

.PP
Simple insertion\&. 
.PP
\fBParameters\fP
.RS 4
\fI__c\fP The character to insert\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
Tries to insert \fC__c\fP\&.
.PP
\fBNote\fP
.RS 4
This function is not overloaded on signed char and unsigned char\&. 
.RE
.PP

.PP
Definition at line 148 of file ostream\&.tcc\&.
.PP
References std::ios_base::goodbit\&.
.SS "void*& std::ios_base::pword (int __ix)\fC [inline]\fP, \fC [inherited]\fP"

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

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

foo\&.ios::rdbuf(p);            // ios == basic_ios<char>
.fi
.PP
 
.PP
Definition at line 53 of file basic_ios\&.tcc\&.
.SS "template<typename _CharT , typename _Traits > \fBiostate\fP \fBstd::basic_ios\fP< _CharT, _Traits >::rdstate () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Returns the error state of the stream buffer\&. 
.PP
\fBReturns\fP
.RS 4
A bit pattern (well, isn't everything?)
.RE
.PP
See std::ios_base::iostate for the possible bit values\&. Most users will call one of the interpreting wrappers, e\&.g\&., good()\&. 
.PP
Definition at line 137 of file basic_ios\&.h\&.
.PP
Referenced by std::basic_ios< _CharT, _Traits >::bad(), std::basic_ios< _CharT, _Traits >::eof(), std::basic_ios< _CharT, _Traits >::fail(), std::basic_ios< _CharT, _Traits >::good(), std::basic_istream< _CharT, _Traits >::seekg(), std::basic_ios< _CharT, _Traits >::setstate(), and std::basic_istream< _CharT, _Traits >::unget()\&.
.SS "void std::ios_base::register_callback (\fBevent_callback\fP __fn, int __index)\fC [inherited]\fP"

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

.PP
Changing the current write position\&. 
.PP
\fBParameters\fP
.RS 4
\fI__off\fP A file offset object\&. 
.br
\fI__dir\fP The direction in which to seek\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
If \fCfail()\fP is not true, calls \fCrdbuf()->pubseekoff(off,dir)\fP\&. If that function fails, sets failbit\&. 
.PP
Definition at line 289 of file ostream\&.tcc\&.
.PP
References std::ios_base::goodbit\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_ostream\fP< _CharT, _Traits > & \fBstd::basic_ostream\fP< _CharT, _Traits >::seekp (pos_type __pos)\fC [inherited]\fP"

.PP
Changing the current write position\&. 
.PP
\fBParameters\fP
.RS 4
\fI__pos\fP A file position object\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
If \fCfail()\fP is not true, calls \fCrdbuf()->pubseekpos(pos)\fP\&. If that function fails, sets failbit\&. 
.PP
Definition at line 257 of file ostream\&.tcc\&.
.PP
References std::ios_base::goodbit\&.
.SS "\fBfmtflags\fP std::ios_base::setf (\fBfmtflags\fP __fmtfl)\fC [inline]\fP, \fC [inherited]\fP"

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

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

.PP
Sets additional flags in the error state\&. 
.PP
\fBParameters\fP
.RS 4
\fI__state\fP The additional state flag(s) to set\&.
.RE
.PP
See std::ios_base::iostate for the possible bit values\&. 
.PP
Definition at line 157 of file basic_ios\&.h\&.
.PP
References std::basic_ios< _CharT, _Traits >::clear(), and std::basic_ios< _CharT, _Traits >::rdstate()\&.
.PP
Referenced by std::basic_ostream< _CharT, _Traits >::sentry::sentry(), and std::ws()\&.
.SS "template<typename _CharT , typename _Traits , typename _Alloc > \fB__string_type\fP \fBstd::basic_ostringstream\fP< _CharT, _Traits, _Alloc >::str () const\fC [inline]\fP"

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

.PP
Definition at line 677 of file sstream\&.
.SS "template<typename _CharT , typename _Traits , typename _Alloc > void \fBstd::basic_ostringstream\fP< _CharT, _Traits, _Alloc >::str (const \fB__string_type\fP & __s)\fC [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 \fCrdbuf()->str(s)\fP\&. 
.PP
Definition at line 687 of file sstream\&.
.SS "static bool std::ios_base::sync_with_stdio (bool __sync = \fCtrue\fP)\fC [static]\fP, \fC [inherited]\fP"

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

.PP
Getting the current write position\&. 
.PP
\fBReturns\fP
.RS 4
A file position object\&.
.RE
.PP
If \fCfail()\fP is not false, returns \fCpos_type\fP(-1) to indicate failure\&. Otherwise returns \fCrdbuf()->pubseekoff(0,cur,out)\fP\&. 
.PP
Definition at line 236 of file ostream\&.tcc\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_ostream\fP<_CharT, _Traits>* \fBstd::basic_ios\fP< _CharT, _Traits >::tie () const\fC [inline]\fP, \fC [inherited]\fP"

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

.PP
Ties this stream to an output stream\&. 
.PP
\fBParameters\fP
.RS 4
\fI__tiestr\fP The output stream\&. 
.RE
.PP
\fBReturns\fP
.RS 4
The previously tied output stream, or NULL if the stream was not tied\&.
.RE
.PP
This sets up a new tie; see tie() for more\&. 
.PP
Definition at line 307 of file basic_ios\&.h\&.
.SS "void std::ios_base::unsetf (\fBfmtflags\fP __mask)\fC [inline]\fP, \fC [inherited]\fP"

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

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

.fi
.PP
.PP
Additional l10n notes are at http://gcc.gnu.org/onlinedocs/libstdc++/manual/localization.html 
.PP
Definition at line 449 of file basic_ios\&.h\&.
.PP
Referenced by std::basic_ios< _CharT, _Traits >::fill(), std::getline(), std::gamma_distribution< double >::operator()(), and std::tr2::operator>>()\&.
.SS "\fBstreamsize\fP std::ios_base::width () const\fC [inline]\fP, \fC [inherited]\fP"

.PP
Flags access\&. 
.PP
\fBReturns\fP
.RS 4
The minimum field width to generate on output operations\&.
.RE
.PP
\fIMinimum field width\fP refers to the number of characters\&. 
.PP
Definition at line 724 of file ios_base\&.h\&.
.PP
Referenced by std::basic_ios< _CharT, _Traits >::copyfmt(), and std::num_put< _CharT, _OutIter >::do_put()\&.
.SS "\fBstreamsize\fP std::ios_base::width (\fBstreamsize\fP __wide)\fC [inline]\fP, \fC [inherited]\fP"

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

.PP
Definition at line 733 of file ios_base\&.h\&.
.SS "template<typename _CharT , typename _Traits > \fBbasic_ostream\fP< _CharT, _Traits > & \fBstd::basic_ostream\fP< _CharT, _Traits >::write (const char_type * __s, \fBstreamsize\fP __n)\fC [inherited]\fP"

.PP
Character string insertion\&. 
.PP
\fBParameters\fP
.RS 4
\fI__s\fP The array to insert\&. 
.br
\fI__n\fP Maximum number of characters to insert\&. 
.RE
.PP
\fBReturns\fP
.RS 4
*this
.RE
.PP
Characters are copied from \fC__s\fP and inserted into the stream until one of the following happens:
.PP
.IP "\(bu" 2
\fC__n\fP characters are inserted
.IP "\(bu" 2
inserting into the output sequence fails (in this case, badbit will be set in the stream's error state)
.PP
.PP
\fBNote\fP
.RS 4
This function is not overloaded on signed char and unsigned char\&. 
.RE
.PP

.PP
Definition at line 182 of file ostream\&.tcc\&.
.SS "static int std::ios_base::xalloc ()\fC [static]\fP, \fC [inherited]\fP"

.PP
Access to unique indices\&. 
.PP
\fBReturns\fP
.RS 4
An integer different from all previous calls\&.
.RE
.PP
This function returns a unique integer every time it is called\&. It can be used for any purpose, but is primarily intended to be a unique index for the iword and pword functions\&. The expectation is that an application calls xalloc in order to obtain an index in the iword and pword arrays that can be used without fear of conflict\&.
.PP
The implementation maintains a static variable that is incremented and returned on each invocation\&. xalloc is guaranteed to return an index that is safe to use in the iword and pword arrays\&. 
.SH "Member Data Documentation"
.PP 
.SS "const \fBfmtflags\fP std::ios_base::adjustfield\fC [static]\fP, \fC [inherited]\fP"

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

.PP
Seek to end before each write\&. 
.PP
Definition at line 432 of file ios_base\&.h\&.
.PP
Referenced by std::basic_filebuf< _CharT, _Traits >::xsputn()\&.
.SS "const \fBopenmode\fP std::ios_base::ate\fC [static]\fP, \fC [inherited]\fP"

.PP
Open and seek to end immediately after opening\&. 
.PP
Definition at line 435 of file ios_base\&.h\&.
.PP
Referenced by std::basic_filebuf< _CharT, _Traits >::open()\&.
.SS "const \fBiostate\fP std::ios_base::badbit\fC [static]\fP, \fC [inherited]\fP"

.PP
Indicates a loss of integrity in an input or output sequence (such as an irrecoverable read error from a file)\&. 
.PP
Definition at line 402 of file ios_base\&.h\&.
.PP
Referenced by std::basic_ios< _CharT, _Traits >::bad(), std::basic_ios< _CharT, _Traits >::fail(), std::basic_istream< char >::get(), and std::basic_istream< char >::read()\&.
.SS "const \fBfmtflags\fP std::ios_base::basefield\fC [static]\fP, \fC [inherited]\fP"

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

.PP
Request a seek relative to the beginning of the stream\&. 
.PP
Definition at line 464 of file ios_base\&.h\&.
.PP
Referenced by std::basic_filebuf< _CharT, _Traits >::seekpos(), and __gnu_cxx::stdio_sync_filebuf< _CharT, _Traits >::seekpos()\&.
.SS "const \fBopenmode\fP std::ios_base::binary\fC [static]\fP, \fC [inherited]\fP"

.PP
Perform input and output in binary mode (as opposed to text mode)\&. This is probably not what you think it is; see https://gcc.gnu.org/onlinedocs/libstdc++/manual/fstreams.html#std.io.filestreams.binary\&. 
.PP
Definition at line 440 of file ios_base\&.h\&.
.SS "const \fBfmtflags\fP std::ios_base::boolalpha\fC [static]\fP, \fC [inherited]\fP"

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

.PP
Request a seek relative to the current position within the sequence\&. 
.PP
Definition at line 467 of file ios_base\&.h\&.
.PP
Referenced by std::basic_filebuf< _CharT, _Traits >::seekoff(), and std::basic_stringbuf< _CharT, _Traits, _Alloc >::seekoff()\&.
.SS "const \fBfmtflags\fP std::ios_base::dec\fC [static]\fP, \fC [inherited]\fP"

.PP
Converts integer input or generates integer output in decimal base\&. 
.PP
Definition at line 329 of file ios_base\&.h\&.
.PP
Referenced by std::dec()\&.
.SS "const \fBseekdir\fP std::ios_base::end\fC [static]\fP, \fC [inherited]\fP"

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

.PP
Indicates that an input operation reached the end of an input sequence\&. 
.PP
Definition at line 405 of file ios_base\&.h\&.
.PP
Referenced by std::time_get< _CharT, _InIter >::do_get(), std::num_get< _CharT, _InIter >::do_get(), std::time_get< _CharT, _InIter >::do_get_date(), std::time_get< _CharT, _InIter >::do_get_monthname(), std::time_get< _CharT, _InIter >::do_get_time(), std::time_get< _CharT, _InIter >::do_get_weekday(), std::time_get< _CharT, _InIter >::do_get_year(), std::basic_ios< _CharT, _Traits >::eof(), std::time_get< _CharT, _InIter >::get(), std::basic_istream< char >::getline(), std::basic_istream< _CharT, _Traits >::seekg(), std::basic_istream< _CharT, _Traits >::unget(), and std::ws()\&.
.SS "const \fBiostate\fP std::ios_base::failbit\fC [static]\fP, \fC [inherited]\fP"

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

.PP
Generate floating-point output in fixed-point notation\&. 
.PP
Definition at line 332 of file ios_base\&.h\&.
.PP
Referenced by std::fixed(), and std::hexfloat()\&.
.SS "const \fBfmtflags\fP std::ios_base::floatfield\fC [static]\fP, \fC [inherited]\fP"

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

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

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

.PP
Open for input\&. Default for \fCifstream\fP and fstream\&. 
.PP
Definition at line 443 of file ios_base\&.h\&.
.PP
Referenced by std::basic_stringbuf< _CharT, _Traits, _Alloc >::seekoff(), std::basic_stringbuf< _CharT, _Traits, _Alloc >::seekpos(), std::basic_filebuf< _CharT, _Traits >::showmanyc(), std::basic_filebuf< _CharT, _Traits >::underflow(), std::basic_stringbuf< _CharT, _Traits, _Alloc >::underflow(), and std::basic_filebuf< _CharT, _Traits >::xsgetn()\&.
.SS "const \fBfmtflags\fP std::ios_base::internal\fC [static]\fP, \fC [inherited]\fP"

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

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

.PP
Converts integer input or generates integer output in octal base\&. 
.PP
Definition at line 347 of file ios_base\&.h\&.
.PP
Referenced by std::oct()\&.
.SS "const \fBopenmode\fP std::ios_base::out\fC [static]\fP, \fC [inherited]\fP"

.PP
Open for output\&. Default for \fCofstream\fP and fstream\&. 
.PP
Definition at line 446 of file ios_base\&.h\&.
.PP
Referenced by std::basic_stringbuf< _CharT, _Traits, _Alloc >::seekoff(), std::basic_stringbuf< _CharT, _Traits, _Alloc >::seekpos(), and std::basic_filebuf< _CharT, _Traits >::xsputn()\&.
.SS "const \fBfmtflags\fP std::ios_base::right\fC [static]\fP, \fC [inherited]\fP"

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

.PP
Generates floating-point output in scientific notation\&. 
.PP
Definition at line 354 of file ios_base\&.h\&.
.PP
Referenced by std::hexfloat(), and std::scientific()\&.
.SS "const \fBfmtflags\fP std::ios_base::showbase\fC [static]\fP, \fC [inherited]\fP"

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

.PP
Generates a decimal-point character unconditionally in generated floating-point output\&. 
.PP
Definition at line 362 of file ios_base\&.h\&.
.PP
Referenced by std::noshowpoint(), and std::showpoint()\&.
.SS "const \fBfmtflags\fP std::ios_base::showpos\fC [static]\fP, \fC [inherited]\fP"

.PP
Generates a + sign in non-negative generated numeric output\&. 
.PP
Definition at line 365 of file ios_base\&.h\&.
.PP
Referenced by std::noshowpos(), and std::showpos()\&.
.SS "const \fBfmtflags\fP std::ios_base::skipws\fC [static]\fP, \fC [inherited]\fP"

.PP
Skips leading white space before certain input operations\&. 
.PP
Definition at line 368 of file ios_base\&.h\&.
.PP
Referenced by std::noskipws(), std::__detail::operator>>(), and std::skipws()\&.
.SS "const \fBopenmode\fP std::ios_base::trunc\fC [static]\fP, \fC [inherited]\fP"

.PP
Truncate an existing stream when opening\&. Default for \fCofstream\fP\&. 
.PP
Definition at line 449 of file ios_base\&.h\&.
.SS "const \fBfmtflags\fP std::ios_base::unitbuf\fC [static]\fP, \fC [inherited]\fP"

.PP
Flushes output after each output operation\&. 
.PP
Definition at line 371 of file ios_base\&.h\&.
.PP
Referenced by std::nounitbuf(), and std::unitbuf()\&.
.SS "const \fBfmtflags\fP std::ios_base::uppercase\fC [static]\fP, \fC [inherited]\fP"

.PP
Replaces certain lowercase letters with their uppercase equivalents in generated output\&. 
.PP
Definition at line 375 of file ios_base\&.h\&.
.PP
Referenced by std::num_put< _CharT, _OutIter >::do_put(), std::nouppercase(), and std::uppercase()\&.

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