.TH "std::basic_fstream< _CharT, _Traits >" 3cxx "Thu Aug 2 2012" "libstdc++" \" -*- nroff -*- .ad l .nh .SH NAME std::basic_fstream< _CharT, _Traits > \- .SH SYNOPSIS .br .PP .PP Inherits \fBstd::basic_iostream< _CharT, _Traits >\fP\&. .SS "Public Types" .in +1c .ti -1c .RI "typedef \fBctype\fP< _CharT > \fB__ctype_type\fP" .br .ti -1c .RI "typedef \fBctype\fP< _CharT > \fB__ctype_type\fP" .br .ti -1c .RI "typedef \fBbasic_filebuf\fP .br < char_type, traits_type > \fB__filebuf_type\fP" .br .ti -1c .RI "typedef \fBbasic_ios\fP< char_type, .br traits_type > \fB__ios_type\fP" .br .ti -1c .RI "typedef \fBbasic_iostream\fP .br < char_type, traits_type > \fB__iostream_type\fP" .br .ti -1c .RI "typedef \fBbasic_istream\fP< _CharT, .br _Traits > \fB__istream_type\fP" .br .ti -1c .RI "typedef \fBnum_get\fP< _CharT, .br \fBistreambuf_iterator\fP< _CharT, .br _Traits > > \fB__num_get_type\fP" .br .ti -1c .RI "typedef \fBnum_put\fP< _CharT, .br \fBostreambuf_iterator\fP< _CharT, .br _Traits > > \fB__num_put_type\fP" .br .ti -1c .RI "typedef \fBbasic_ostream\fP< _CharT, .br _Traits > \fB__ostream_type\fP" .br .ti -1c .RI "typedef \fBbasic_streambuf\fP .br < _CharT, _Traits > \fB__streambuf_type\fP" .br .ti -1c .RI "typedef \fBbasic_streambuf\fP .br < _CharT, _Traits > \fB__streambuf_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 .ti -1c .RI "typedef void(* \fBevent_callback\fP )(\fBevent\fP, \fBios_base\fP &, int)" .br .ti -1c .RI "typedef _Ios_Fmtflags \fBfmtflags\fP" .br .ti -1c .RI "typedef traits_type::int_type \fBint_type\fP" .br .ti -1c .RI "typedef int \fBio_state\fP" .br .ti -1c .RI "typedef _Ios_Iostate \fBiostate\fP" .br .ti -1c .RI "typedef traits_type::off_type \fBoff_type\fP" .br .ti -1c .RI "typedef int \fBopen_mode\fP" .br .ti -1c .RI "typedef _Ios_Openmode \fBopenmode\fP" .br .ti -1c .RI "typedef traits_type::pos_type \fBpos_type\fP" .br .ti -1c .RI "typedef int \fBseek_dir\fP" .br .ti -1c .RI "typedef _Ios_Seekdir \fBseekdir\fP" .br .ti -1c .RI "typedef \fBstd::streamoff\fP \fBstreamoff\fP" .br .ti -1c .RI "typedef \fBstd::streampos\fP \fBstreampos\fP" .br .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, .br \fBostreambuf_iterator\fP< _CharT, .br _Traits > > \fB__num_put_type\fP" .br .in -1c .in -1c .SS "Public Member Functions" .in +1c .ti -1c .RI "const \fBlocale\fP & \fB_M_getloc\fP () const " .br .ti -1c .RI "void \fB_M_setstate\fP (\fBiostate\fP __state)" .br .ti -1c .RI "bool \fBbad\fP () const " .br .ti -1c .RI "\fBbasic_fstream\fP ()" .br .ti -1c .RI "\fBbasic_fstream\fP (const char *__s, \fBios_base::openmode\fP __mode=\fBios_base::in\fP|\fBios_base::out\fP)" .br .ti -1c .RI "\fBbasic_fstream\fP (const \fBstd::string\fP &__s, \fBios_base::openmode\fP __mode=\fBios_base::in\fP|\fBios_base::out\fP)" .br .ti -1c .RI "void \fBclear\fP (\fBiostate\fP __state=\fBgoodbit\fP)" .br .ti -1c .RI "void \fBclose\fP ()" .br .ti -1c .RI "\fBbasic_ios\fP & \fBcopyfmt\fP (const \fBbasic_ios\fP &__rhs)" .br .ti -1c .RI "bool \fBeof\fP () const " .br .ti -1c .RI "\fBiostate\fP \fBexceptions\fP () const " .br .ti -1c .RI "void \fBexceptions\fP (\fBiostate\fP __except)" .br .ti -1c .RI "bool \fBfail\fP () const " .br .ti -1c .RI "char_type \fBfill\fP () const " .br .ti -1c .RI "char_type \fBfill\fP (char_type __ch)" .br .ti -1c .RI "\fBfmtflags\fP \fBflags\fP () const " .br .ti -1c .RI "\fBfmtflags\fP \fBflags\fP (\fBfmtflags\fP __fmtfl)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBflush\fP ()" .br .ti -1c .RI "\fBstreamsize\fP \fBgcount\fP () const " .br .ti -1c .RI "template<> \fBbasic_istream\fP< char > & \fBgetline\fP (char_type *__s, \fBstreamsize\fP __n, char_type __delim)" .br .ti -1c .RI "template<> \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 .ti -1c .RI "bool \fBgood\fP () const " .br .ti -1c .RI "template<> \fBbasic_istream\fP< char > & \fBignore\fP (\fBstreamsize\fP __n)" .br .ti -1c .RI "template<> \fBbasic_istream\fP< char > & \fBignore\fP (\fBstreamsize\fP __n, int_type __delim)" .br .ti -1c .RI "template<> \fBbasic_istream\fP< wchar_t > & \fBignore\fP (\fBstreamsize\fP __n)" .br .ti -1c .RI "template<> \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 .ti -1c .RI "bool \fBis_open\fP ()" .br .ti -1c .RI "bool \fBis_open\fP () const " .br .ti -1c .RI "long & \fBiword\fP (int __ix)" .br .ti -1c .RI "char \fBnarrow\fP (char_type __c, char __dfault) const " .br .ti -1c .RI "void \fBopen\fP (const char *__s, \fBios_base::openmode\fP __mode=\fBios_base::in\fP|\fBios_base::out\fP)" .br .ti -1c .RI "void \fBopen\fP (const \fBstd::string\fP &__s, \fBios_base::openmode\fP __mode=\fBios_base::in\fP|\fBios_base::out\fP)" .br .ti -1c .RI "\fBstreamsize\fP \fBprecision\fP () const " .br .ti -1c .RI "\fBstreamsize\fP \fBprecision\fP (\fBstreamsize\fP __prec)" .br .ti -1c .RI "void *& \fBpword\fP (int __ix)" .br .ti -1c .RI "\fBbasic_streambuf\fP< _CharT, .br _Traits > * \fBrdbuf\fP (\fBbasic_streambuf\fP< _CharT, _Traits > *__sb)" .br .ti -1c .RI "\fB__filebuf_type\fP * \fBrdbuf\fP () const " .br .ti -1c .RI "\fBiostate\fP \fBrdstate\fP () const " .br .ti -1c .RI "void \fBregister_callback\fP (\fBevent_callback\fP __fn, int __index)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBseekp\fP (pos_type)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBseekp\fP (off_type, \fBios_base::seekdir\fP)" .br .ti -1c .RI "\fBfmtflags\fP \fBsetf\fP (\fBfmtflags\fP __fmtfl)" .br .ti -1c .RI "\fBfmtflags\fP \fBsetf\fP (\fBfmtflags\fP __fmtfl, \fBfmtflags\fP __mask)" .br .ti -1c .RI "void \fBsetstate\fP (\fBiostate\fP __state)" .br .ti -1c .RI "pos_type \fBtellp\fP ()" .br .ti -1c .RI "\fBbasic_ostream\fP< _CharT, _Traits > * \fBtie\fP () const " .br .ti -1c .RI "\fBbasic_ostream\fP< _CharT, _Traits > * \fBtie\fP (\fBbasic_ostream\fP< _CharT, _Traits > *__tiestr)" .br .ti -1c .RI "void \fBunsetf\fP (\fBfmtflags\fP __mask)" .br .ti -1c .RI "char_type \fBwiden\fP (char __c) const " .br .ti -1c .RI "\fBstreamsize\fP \fBwidth\fP () const " .br .ti -1c .RI "\fBstreamsize\fP \fBwidth\fP (\fBstreamsize\fP __wide)" .br .ti -1c .RI "\fB~basic_fstream\fP ()" .br .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 .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (\fB__ios_type\fP &(*__pf)(\fB__ios_type\fP &))" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (\fBios_base\fP &(*__pf)(\fBios_base\fP &))" .br .in -1c .in -1c .PP .RI "\fBArithmetic Extractors\fP" .br All the \fCoperator>>\fP functions (aka \fIformatted input functions\fP) have some common behavior\&. Each starts by constructing a temporary object of type \fBstd::basic_istream::sentry\fP 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, \fBios_base::badbit\fP will be turned on in the stream's error state without causing an \fBios_base::failure\fP to be thrown\&. The original exception will then be rethrown\&. .PP .in +1c .in +1c .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (bool &__n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (short &__n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (unsigned short &__n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (int &__n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (unsigned int &__n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (long &__n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (unsigned long &__n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (long long &__n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (unsigned long long &__n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (float &__f)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (double &__f)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (long double &__f)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (void *&__p)" .br .ti -1c .RI "\fB__istream_type\fP & \fBoperator>>\fP (\fB__streambuf_type\fP *__sb)" .br .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 \fBstd::basic_istream::sentry\fP 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 \fBgcount()\fP\&. .PP If an exception is thrown during extraction, \fBios_base::badbit\fP will be turned on in the stream's error state without causing an \fBios_base::failure\fP to be thrown\&. The original exception will then be rethrown\&. .PP .in +1c .in +1c .ti -1c .RI "int_type \fBget\fP ()" .br .ti -1c .RI "\fB__istream_type\fP & \fBget\fP (char_type &__c)" .br .ti -1c .RI "\fB__istream_type\fP & \fBget\fP (char_type *__s, \fBstreamsize\fP __n, char_type __delim)" .br .ti -1c .RI "\fB__istream_type\fP & \fBget\fP (char_type *__s, \fBstreamsize\fP __n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBget\fP (\fB__streambuf_type\fP &__sb, char_type __delim)" .br .ti -1c .RI "\fB__istream_type\fP & \fBget\fP (\fB__streambuf_type\fP &__sb)" .br .ti -1c .RI "\fB__istream_type\fP & \fBgetline\fP (char_type *__s, \fBstreamsize\fP __n, char_type __delim)" .br .ti -1c .RI "\fB__istream_type\fP & \fBgetline\fP (char_type *__s, \fBstreamsize\fP __n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBignore\fP ()" .br .ti -1c .RI "\fB__istream_type\fP & \fBignore\fP (\fBstreamsize\fP __n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBignore\fP (\fBstreamsize\fP __n, int_type __delim)" .br .ti -1c .RI "int_type \fBpeek\fP ()" .br .ti -1c .RI "\fB__istream_type\fP & \fBread\fP (char_type *__s, \fBstreamsize\fP __n)" .br .ti -1c .RI "\fBstreamsize\fP \fBreadsome\fP (char_type *__s, \fBstreamsize\fP __n)" .br .ti -1c .RI "\fB__istream_type\fP & \fBputback\fP (char_type __c)" .br .ti -1c .RI "\fB__istream_type\fP & \fBunget\fP ()" .br .ti -1c .RI "int \fBsync\fP ()" .br .ti -1c .RI "pos_type \fBtellg\fP ()" .br .ti -1c .RI "\fB__istream_type\fP & \fBseekg\fP (pos_type)" .br .ti -1c .RI "\fB__istream_type\fP & \fBseekg\fP (off_type, \fBios_base::seekdir\fP)" .br .in -1c .in -1c .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "\fBoperator void *\fP () const " .br .ti -1c .RI "bool \fBoperator!\fP () const " .br .in -1c .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 .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (\fB__ios_type\fP &(*__pf)(\fB__ios_type\fP &))" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (\fBios_base\fP &(*__pf)(\fBios_base\fP &))" .br .in -1c .in -1c .PP .RI "\fBArithmetic Inserters\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 \fBstd::basic_ostream::sentry\fP\&. 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, \fBios_base::badbit\fP will be turned on in the stream's error state without causing an \fBios_base::failure\fP 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 .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (unsigned long __n)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (bool __n)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (short __n)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (unsigned short __n)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (int __n)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (unsigned int __n)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (long long __n)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (unsigned long long __n)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (double __f)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (float __f)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (long double __f)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (const void *__p)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBoperator<<\fP (\fB__streambuf_type\fP *__sb)" .br .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 \fBstd::basic_ostream::sentry\fP\&. 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, \fBios_base::badbit\fP 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 .ti -1c .RI "void \fB_M_write\fP (const char_type *__s, \fBstreamsize\fP __n)" .br .ti -1c .RI "\fB__ostream_type\fP & \fBwrite\fP (const char_type *__s, \fBstreamsize\fP __n)" .br .in -1c .in -1c .SS "Static Public Member Functions" .in +1c .ti -1c .RI "static bool \fBsync_with_stdio\fP (bool __sync=true)" .br .ti -1c .RI "static int \fBxalloc\fP () throw ()" .br .in -1c .SS "Static Public Attributes" .in +1c .ti -1c .RI "static const \fBfmtflags\fP \fBadjustfield\fP" .br .ti -1c .RI "static const \fBopenmode\fP \fBapp\fP" .br .ti -1c .RI "static const \fBopenmode\fP \fBate\fP" .br .ti -1c .RI "static const \fBiostate\fP \fBbadbit\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBbasefield\fP" .br .ti -1c .RI "static const \fBseekdir\fP \fBbeg\fP" .br .ti -1c .RI "static const \fBopenmode\fP \fBbinary\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBboolalpha\fP" .br .ti -1c .RI "static const \fBseekdir\fP \fBcur\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBdec\fP" .br .ti -1c .RI "static const \fBseekdir\fP \fBend\fP" .br .ti -1c .RI "static const \fBiostate\fP \fBeofbit\fP" .br .ti -1c .RI "static const \fBiostate\fP \fBfailbit\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBfixed\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBfloatfield\fP" .br .ti -1c .RI "static const \fBiostate\fP \fBgoodbit\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBhex\fP" .br .ti -1c .RI "static const \fBopenmode\fP \fBin\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBinternal\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBleft\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBoct\fP" .br .ti -1c .RI "static const \fBopenmode\fP \fBout\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBright\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBscientific\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBshowbase\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBshowpoint\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBshowpos\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBskipws\fP" .br .ti -1c .RI "static const \fBopenmode\fP \fBtrunc\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBunitbuf\fP" .br .ti -1c .RI "static const \fBfmtflags\fP \fBuppercase\fP" .br .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)" .br .ti -1c .RI "template \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 ()" .br .ti -1c .RI "template \fB__ostream_type\fP & \fB_M_insert\fP (_ValueT __v)" .br .ti -1c .RI "void \fBinit\fP (\fBbasic_streambuf\fP< _CharT, _Traits > *__sb)" .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 "char_type \fB_M_fill\fP" .br .ti -1c .RI "bool \fB_M_fill_init\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 "\fBbasic_streambuf\fP< _CharT, .br _Traits > * \fB_M_streambuf\fP" .br .ti -1c .RI "\fBbasic_ostream\fP< _CharT, _Traits > * \fB_M_tie\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 .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "\fBstreamsize\fP \fB_M_precision\fP" .br .ti -1c .RI "\fBstreamsize\fP \fB_M_width\fP" .br .ti -1c .RI "\fBfmtflags\fP \fB_M_flags\fP" .br .ti -1c .RI "\fBiostate\fP \fB_M_exception\fP" .br .ti -1c .RI "\fBiostate\fP \fB_M_streambuf_state\fP" .br .in -1c .in -1c .SH "Detailed Description" .PP .SS "templateclass std::basic_fstream< _CharT, _Traits >" Controlling input and output for files\&. .PP This class supports reading from and writing to named files, using the inherited functions from \fBstd::basic_iostream\fP\&. To control the associated sequence, an instance of \fBstd::basic_filebuf\fP is used, which this page refers to as \fCsb\fP\&. .PP Definition at line 755 of file fstream\&. .SH "Member Typedef Documentation" .PP .SS "template typedef \fBnum_put\fP<_CharT, \fBostreambuf_iterator\fP<_CharT, _Traits> > \fBstd::basic_ios\fP< _CharT, _Traits >::\fB__num_put_type\fP\fC [inherited]\fP" These are non-standard types\&. .PP Definition at line 84 of file basic_ios\&.h\&. .SS "typedef void(* std::ios_base::event_callback)(\fBevent\fP, \fBios_base\fP &, int)\fC [inherited]\fP" .PP The type of an event callback function\&. \fBParameters:\fP .RS 4 \fIevent\fP One of the members of the event enum\&. .br \fI\fBios_base\fP\fP Reference to the \fBios_base\fP object\&. .br \fIint\fP The integer provided when the callback was registered\&. .RE .PP Event callbacks are user defined functions that get called during several \fBios_base\fP and \fBbasic_ios\fP functions, specifically \fBimbue()\fP, copyfmt(), and ~ios()\&. .PP Definition at line 444 of file ios_base\&.h\&. .SS "typedef _Ios_Fmtflags std::ios_base::fmtflags\fC [inherited]\fP" .PP This is a bitmask type\&. \fC'_Ios_Fmtflags'\fP is 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 263 of file ios_base\&.h\&. .SS "typedef _Ios_Iostate std::ios_base::iostate\fC [inherited]\fP" .PP This is a bitmask type\&. \fC'_Ios_Iostate'\fP is 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 338 of file ios_base\&.h\&. .SS "typedef _Ios_Openmode std::ios_base::openmode\fC [inherited]\fP" .PP This is a bitmask type\&. \fC'_Ios_Openmode'\fP is 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 369 of file ios_base\&.h\&. .SS "typedef _Ios_Seekdir std::ios_base::seekdir\fC [inherited]\fP" .PP This is an enumerated type\&. \fC'_Ios_Seekdir'\fP is 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 401 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 \fBimbue()\fP\&. copyfmt_event is used during copyfmt()\&. .PP Definition at line 427 of file ios_base\&.h\&. .SH "Constructor & Destructor Documentation" .PP .SS "template \fBstd::basic_fstream\fP< _CharT, _Traits >::\fBbasic_fstream\fP ()\fC [inline]\fP" .PP Default constructor\&. Initializes \fCsb\fP using its default constructor, and passes \fC&sb\fP to the base class initializer\&. Does not open any files (you haven't given it a filename to open)\&. .PP Definition at line 782 of file fstream\&. .SS "template \fBstd::basic_fstream\fP< _CharT, _Traits >::\fBbasic_fstream\fP (const char *__s, \fBios_base::openmode\fP__mode = \fC\fBios_base::in\fP | \fBios_base::out\fP\fP)\fC [inline]\fP, \fC [explicit]\fP" .PP Create an input/output file stream\&. \fBParameters:\fP .RS 4 \fIs\fP Null terminated string specifying the filename\&. .br \fImode\fP Open file in specified mode (see \fBstd::ios_base\fP)\&. .RE .PP Tip: When using std::string to hold the filename, you must use \&.c_str() before passing it to this constructor\&. .PP Definition at line 795 of file fstream\&. .SS "template \fBstd::basic_fstream\fP< _CharT, _Traits >::\fBbasic_fstream\fP (const \fBstd::string\fP &__s, \fBios_base::openmode\fP__mode = \fC\fBios_base::in\fP | \fBios_base::out\fP\fP)\fC [inline]\fP, \fC [explicit]\fP" .PP Create an input/output file stream\&. \fBParameters:\fP .RS 4 \fIs\fP Null terminated string specifying the filename\&. .br \fImode\fP Open file in specified mode (see \fBstd::ios_base\fP)\&. .RE .PP .PP Definition at line 810 of file fstream\&. .SS "template \fBstd::basic_fstream\fP< _CharT, _Traits >::~\fBbasic_fstream\fP ()\fC [inline]\fP" .PP The destructor does nothing\&. The file is closed by the filebuf object, not the formatting stream\&. .PP Definition at line 825 of file fstream\&. .SH "Member Function Documentation" .PP .SS "const \fBlocale\fP& std::ios_base::_M_getloc () const\fC [inline]\fP, \fC [inherited]\fP" .PP Locale access\&. \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 710 of file ios_base\&.h\&. .PP Referenced by std::money_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::time_put< _CharT, _OutIter >::do_put(), std::num_put< _CharT, _OutIter >::do_put(), and std::time_put< _CharT, _OutIter >::put()\&. .SS "template void \fBstd::basic_ostream\fP< _CharT, _Traits >::_M_write (const char_type *__s, \fBstreamsize\fP__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Simple insertion\&. \fBParameters:\fP .RS 4 \fIc\fP The character to insert\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP Tries to insert \fIc\fP\&. .PP \fBNote:\fP .RS 4 This function is not overloaded on signed char and unsigned char\&. .RE .PP .PP Definition at line 287 of file ostream\&. .SS "template bool \fBstd::basic_ios\fP< _CharT, _Traits >::bad () const\fC [inline]\fP, \fC [inherited]\fP" .PP Fast error checking\&. \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 201 of file basic_ios\&.h\&. .SS "template void \fBstd::basic_ios\fP< _CharT, _Traits >::clear (\fBiostate\fP__state = \fC\fBgoodbit\fP\fP)\fC [inherited]\fP" .PP [Re]sets the error state\&. \fBParameters:\fP .RS 4 \fIstate\fP The new state flag(s) to set\&. .RE .PP See \fBstd::ios_base::iostate\fP for the possible bit values\&. Most users will not need to pass an argument\&. .PP Definition at line 40 of file basic_ios\&.tcc\&. .SS "template void \fBstd::basic_fstream\fP< _CharT, _Traits >::close ()\fC [inline]\fP" .PP Close the file\&. Calls \fC\fBstd::basic_filebuf::close()\fP\fP\&. If that function fails, \fCfailbit\fP is set in the stream's error state\&. .PP Definition at line 905 of file fstream\&. .SS "template \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\&. \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 \fBrdbuf()\fP and \fBrdstate()\fP 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 \fBexceptions()\fP\&. .PP Definition at line 62 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(), and std::ios_base::width()\&. .SS "template bool \fBstd::basic_ios\fP< _CharT, _Traits >::eof () const\fC [inline]\fP, \fC [inherited]\fP" .PP Fast error checking\&. \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 180 of file basic_ios\&.h\&. .SS "template \fBiostate\fP \fBstd::basic_ios\fP< _CharT, _Traits >::exceptions () const\fC [inline]\fP, \fC [inherited]\fP" .PP Throwing exceptions on errors\&. \fBReturns:\fP .RS 4 The current exceptions mask\&. .RE .PP This changes nothing in the stream\&. See the one-argument version of \fBexceptions(iostate)\fP for the meaning of the return value\&. .PP Definition at line 212 of file basic_ios\&.h\&. .PP Referenced by std::basic_ios< _CharT, _Traits >::copyfmt()\&. .SS "template void \fBstd::basic_ios\fP< _CharT, _Traits >::exceptions (\fBiostate\fP__except)\fC [inline]\fP, \fC [inherited]\fP" .PP Throwing exceptions on errors\&. \fBParameters:\fP .RS 4 \fIexcept\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 \fBstd::ios_base::failure\fP 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 #include #include 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 247 of file basic_ios\&.h\&. .SS "template bool \fBstd::basic_ios\fP< _CharT, _Traits >::fail () const\fC [inline]\fP, \fC [inherited]\fP" .PP Fast error checking\&. \fBReturns:\fP .RS 4 True if either the badbit or the failbit is set\&. .RE .PP Checking the badbit in \fBfail()\fP is historical practice\&. Note that other iostate flags may also be set\&. .PP Definition at line 191 of file basic_ios\&.h\&. .SS "template char_type \fBstd::basic_ios\fP< _CharT, _Traits >::fill () const\fC [inline]\fP, \fC [inherited]\fP" .PP Retrieves the 'empty' character\&. \fBReturns:\fP .RS 4 The current fill character\&. .RE .PP It defaults to a space (' ') in the current locale\&. .PP Definition at line 360 of file basic_ios\&.h\&. .PP Referenced by std::basic_ios< _CharT, _Traits >::copyfmt()\&. .SS "template char_type \fBstd::basic_ios\fP< _CharT, _Traits >::fill (\fBchar_type\fP__ch)\fC [inline]\fP, \fC [inherited]\fP" .PP Sets a new 'empty' character\&. \fBParameters:\fP .RS 4 \fIch\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::copyfmt(), std::num_get< _CharT, _InIter >::do_get(), std::num_put< _CharT, _OutIter >::do_put(), and std::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\&. \fBParameters:\fP .RS 4 \fIfmtfl\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 \fIfmtfl\fP\&. .PP Definition at line 566 of file ios_base\&.h\&. .SS "template \fBbasic_ostream\fP< _CharT, _Traits > & \fBstd::basic_ostream\fP< _CharT, _Traits >::flush ()\fC [inherited]\fP" .PP Synchronizing the stream buffer\&. \fBReturns:\fP .RS 4 *this .RE .PP If \fC\fBrdbuf()\fP\fP is a null pointer, changes nothing\&. .PP Otherwise, calls \fC\fBrdbuf()\fP->pubsync()\fP, and if that returns -1, sets badbit\&. .PP Definition at line 211 of file ostream\&.tcc\&. .PP Referenced by std::flush()\&. .SS "template \fBstreamsize\fP \fBstd::basic_istream\fP< _CharT, _Traits >::gcount () const\fC [inline]\fP, \fC [inherited]\fP" .PP Character counting\&. \fBReturns:\fP .RS 4 The number of characters extracted by the previous unformatted input function dispatched for this stream\&. .RE .PP .PP Definition at line 248 of file istream\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits >::int_type \fBstd::basic_istream\fP< _CharT, _Traits >::get (void)\fC [inherited]\fP" .PP Simple extraction\&. \fBReturns:\fP .RS 4 A character, or \fBeof()\fP\&. .RE .PP Tries to extract a character\&. If none are available, sets failbit and returns traits::eof()\&. .PP Definition at line 186 of file istream\&.tcc\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::get (char_type &__c)\fC [inherited]\fP" .PP Simple extraction\&. \fBParameters:\fP .RS 4 \fIc\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 \fIc\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 Definition at line 222 of file istream\&.tcc\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::get (char_type *__s, \fBstreamsize\fP__n, char_type__delim)\fC [inherited]\fP" .PP Simple multiple-character extraction\&. \fBParameters:\fP .RS 4 \fIs\fP Pointer to an array\&. .br \fIn\fP Maximum number of characters to store in \fIs\fP\&. .br \fIdelim\fP A 'stop' character\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP Characters are extracted and stored into \fIs\fP until one of the following happens: .PP .IP "\(bu" 2 \fCn-1\fP characters are stored .IP "\(bu" 2 the input sequence reaches EOF .IP "\(bu" 2 the next character equals \fIdelim\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 Definition at line 259 of file istream\&.tcc\&. .PP References std::basic_streambuf< _CharT, _Traits >::sgetc(), and std::basic_streambuf< _CharT, _Traits >::snextc()\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::get (char_type *__s, \fBstreamsize\fP__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Simple multiple-character extraction\&. \fBParameters:\fP .RS 4 \fIs\fP Pointer to an array\&. .br \fIn\fP Maximum number of characters to store in \fIs\fP\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP Returns \fCget\fP(s,n,widen(' .br '))\&. .PP Definition at line 332 of file istream\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::get (\fB__streambuf_type\fP &__sb, char_type__delim)\fC [inherited]\fP" .PP Extraction into another streambuf\&. \fBParameters:\fP .RS 4 \fIsb\fP A streambuf in which to store data\&. .br \fIdelim\fP A 'stop' character\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP Characters are extracted and inserted into \fIsb\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 \fIdelim\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 Definition at line 306 of file istream\&.tcc\&. .PP References std::basic_streambuf< _CharT, _Traits >::sgetc(), std::basic_streambuf< _CharT, _Traits >::snextc(), and std::basic_streambuf< _CharT, _Traits >::sputc()\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::get (\fB__streambuf_type\fP &__sb)\fC [inline]\fP, \fC [inherited]\fP" .PP Extraction into another streambuf\&. \fBParameters:\fP .RS 4 \fIsb\fP A streambuf in which to store data\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP Returns \fCget\fP(sb,widen(' .br '))\&. .PP Definition at line 365 of file istream\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::getline (char_type *__s, \fBstreamsize\fP__n, char_type__delim)\fC [inherited]\fP" .PP String extraction\&. \fBParameters:\fP .RS 4 \fIs\fP A character array in which to store the data\&. .br \fIn\fP Maximum number of characters to extract\&. .br \fIdelim\fP A 'stop' character\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP Extracts and stores characters into \fIs\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 \fIs\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 \fCdelim\fP, in which case the character is extracted (and therefore counted in \fC\fBgcount()\fP\fP) but not stored .IP "3." 4 \fCn-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 Definition at line 350 of file istream\&.tcc\&. .PP References std::basic_streambuf< _CharT, _Traits >::sbumpc(), std::basic_streambuf< _CharT, _Traits >::sgetc(), and std::basic_streambuf< _CharT, _Traits >::snextc()\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::getline (char_type *__s, \fBstreamsize\fP__n)\fC [inline]\fP, \fC [inherited]\fP" .PP String extraction\&. \fBParameters:\fP .RS 4 \fIs\fP A character array in which to store the data\&. .br \fIn\fP Maximum number of characters to extract\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP Returns \fCgetline\fP(s,n,widen(' .br '))\&. .PP Definition at line 405 of file istream\&. .PP Referenced by std::basic_istream< char >::getline()\&. .SS "\fBlocale\fP std::ios_base::getloc () const\fC [inline]\fP, \fC [inherited]\fP" .PP Locale access\&. \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 699 of file ios_base\&.h\&. .PP Referenced by std::basic_ios< _CharT, _Traits >::copyfmt(), std::money_put< _CharT, _OutIter >::do_put(), std::operator>>(), and std::ws()\&. .SS "template bool \fBstd::basic_ios\fP< _CharT, _Traits >::good () const\fC [inline]\fP, \fC [inherited]\fP" .PP Fast error checking\&. \fBReturns:\fP .RS 4 True if no error flags are set\&. .RE .PP A wrapper around rdstate\&. .PP Definition at line 170 of file basic_ios\&.h\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::ignore (void)\fC [inherited]\fP" .PP Discarding characters\&. \fBParameters:\fP .RS 4 \fIn\fP Number of characters to discard\&. .br \fIdelim\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 \fIn\fP \fC!=\fP \fC\fBstd::numeric_limits::max()\fP\fP, \fIn\fP characters are extracted .IP "\(bu" 2 the input sequence reaches end-of-file .IP "\(bu" 2 the next character equals \fIdelim\fP (in this case, the character is extracted); note that this condition will never occur if \fIdelim\fP equals \fCtraits::eof()\fP\&. .PP .PP NB: Provide three overloads, instead of the single function (with defaults) mandated by the Standard: this leads to a better performing implementation, while still conforming to the Standard\&. .PP Definition at line 410 of file istream\&.tcc\&. .PP References std::basic_streambuf< _CharT, _Traits >::sbumpc()\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::ignore (\fBstreamsize\fP__n)\fC [inherited]\fP" .PP Simple extraction\&. \fBReturns:\fP .RS 4 A character, or \fBeof()\fP\&. .RE .PP Tries to extract a character\&. If none are available, sets failbit and returns traits::eof()\&. .PP Definition at line 443 of file istream\&.tcc\&. .PP References std::basic_streambuf< _CharT, _Traits >::sgetc(), and std::basic_streambuf< _CharT, _Traits >::snextc()\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::ignore (\fBstreamsize\fP__n, int_type__delim)\fC [inherited]\fP" .PP Simple extraction\&. \fBReturns:\fP .RS 4 A character, or \fBeof()\fP\&. .RE .PP Tries to extract a character\&. If none are available, sets failbit and returns traits::eof()\&. .PP Definition at line 505 of file istream\&.tcc\&. .PP References std::basic_streambuf< _CharT, _Traits >::sbumpc(), std::basic_streambuf< _CharT, _Traits >::sgetc(), and std::basic_streambuf< _CharT, _Traits >::snextc()\&. .SS "template \fBlocale\fP \fBstd::basic_ios\fP< _CharT, _Traits >::imbue (const \fBlocale\fP &__loc)\fC [inherited]\fP" .PP Moves to a new locale\&. \fBParameters:\fP .RS 4 \fIloc\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 Reimplemented from \fBstd::ios_base\fP\&. .PP Definition at line 113 of file basic_ios\&.tcc\&. .PP Referenced by std::operator<<()\&. .SS "template 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 125 of file basic_ios\&.tcc\&. .SS "template bool \fBstd::basic_fstream\fP< _CharT, _Traits >::is_open ()\fC [inline]\fP" .PP Wrapper to test for an open file\&. \fBReturns:\fP .RS 4 \fC\fBrdbuf()\fP->\fBis_open()\fP\fP .RE .PP .PP Definition at line 844 of file fstream\&. .PP References std::basic_filebuf< _CharT, _Traits >::is_open()\&. .SS "long& std::ios_base::iword (int__ix)\fC [inline]\fP, \fC [inherited]\fP" .PP Access to integer array\&. \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 745 of file ios_base\&.h\&. .SS "template char \fBstd::basic_ios\fP< _CharT, _Traits >::narrow (\fBchar_type\fP__c, char__dfault) const\fC [inline]\fP, \fC [inherited]\fP" .PP Squeezes characters\&. \fBParameters:\fP .RS 4 \fIc\fP The character to narrow\&. .br \fIdfault\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 >(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 420 of file basic_ios\&.h\&. .SS "template void \fBstd::basic_fstream\fP< _CharT, _Traits >::open (const char *__s, \fBios_base::openmode\fP__mode = \fC\fBios_base::in\fP | \fBios_base::out\fP\fP)\fC [inline]\fP" .PP Opens an external file\&. \fBParameters:\fP .RS 4 \fIs\fP The name of the file\&. .br \fImode\fP The open mode flags\&. .RE .PP Calls \fCstd::basic_filebuf::open(s,mode)\fP\&. If that function fails, \fCfailbit\fP is set in the stream's error state\&. .PP Tip: When using std::string to hold the filename, you must use \&.c_str() before passing it to this constructor\&. .PP Definition at line 865 of file fstream\&. .SS "template void \fBstd::basic_fstream\fP< _CharT, _Traits >::open (const \fBstd::string\fP &__s, \fBios_base::openmode\fP__mode = \fC\fBios_base::in\fP | \fBios_base::out\fP\fP)\fC [inline]\fP" .PP Opens an external file\&. \fBParameters:\fP .RS 4 \fIs\fP The name of the file\&. .br \fImode\fP The open mode flags\&. .RE .PP Calls \fCstd::basic_filebuf::open(s,mode)\fP\&. If that function fails, \fCfailbit\fP is set in the stream's error state\&. .PP Definition at line 886 of file fstream\&. .SS "template \fBstd::basic_ios\fP< _CharT, _Traits >::operator void * () const\fC [inline]\fP, \fC [inherited]\fP" .PP The quick-and-easy status check\&. This allows you to write constructs such as 'if (!a_stream) \&.\&.\&.' and 'while (a_stream) \&.\&.\&.' .PP Definition at line 111 of file basic_ios\&.h\&. .SS "template 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 'if (!a_stream) \&.\&.\&.' and 'while (a_stream) \&.\&.\&.' .PP Definition at line 115 of file basic_ios\&.h\&. .SS "template \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 \fC\fBstd::endl\fP\fP and \fC\fBstd::hex\fP\fP use these functions in constructs like 'std::cout << std::endl'\&. For more information, see the iomanip header\&. .PP Definition at line 108 of file ostream\&. .SS "template \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 \fC\fBstd::endl\fP\fP and \fC\fBstd::hex\fP\fP use these functions in constructs like 'std::cout << std::endl'\&. For more information, see the iomanip header\&. .PP Definition at line 117 of file ostream\&. .SS "template \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 \fC\fBstd::endl\fP\fP and \fC\fBstd::hex\fP\fP use these functions in constructs like 'std::cout << std::endl'\&. For more information, see the iomanip header\&. .PP Definition at line 127 of file ostream\&. .SS "template \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (long__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 165 of file ostream\&. .SS "template \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (unsigned long__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 169 of file ostream\&. .SS "template \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (bool__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 173 of file ostream\&. .SS "template \fBbasic_ostream\fP< _CharT, _Traits > & \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (short__n)\fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 92 of file ostream\&.tcc\&. .PP References std::hex(), and std::oct()\&. .SS "template \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (unsigned short__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 180 of file ostream\&. .SS "template \fBbasic_ostream\fP< _CharT, _Traits > & \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (int__n)\fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 106 of file ostream\&.tcc\&. .PP References std::hex(), and std::oct()\&. .SS "template \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (unsigned int__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 191 of file ostream\&. .SS "template \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (long long__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 200 of file ostream\&. .SS "template \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (unsigned long long__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 204 of file ostream\&. .SS "template \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (double__f)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 209 of file ostream\&. .SS "template \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (float__f)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 213 of file ostream\&. .SS "template \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (long double__f)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 221 of file ostream\&. .SS "template \fB__ostream_type\fP& \fBstd::basic_ostream\fP< _CharT, _Traits >::operator<< (const void *__p)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic inserters\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to perform numeric formatting\&. .PP Definition at line 225 of file ostream\&. .SS "template \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\&. \fBParameters:\fP .RS 4 \fIsb\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 \fIsb\fP is NULL, the stream will set failbit in its error state\&. .PP Characters are extracted from \fIsb\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 \fIsb\fP, which sets failbit in the error state .PP .PP If the function inserts no characters, failbit is set\&. .PP Definition at line 120 of file ostream\&.tcc\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (\fB__istream_type\fP &(*)(\fB__istream_type\fP &)__pf)\fC [inline]\fP, \fC [inherited]\fP" .PP Interface for manipulators\&. Manipulators such as \fC\fBstd::ws\fP\fP and \fC\fBstd::dec\fP\fP use these functions in constructs like 'std::cin >> std::ws'\&. For more information, see the iomanip header\&. .PP Definition at line 119 of file istream\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\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 \fC\fBstd::ws\fP\fP and \fC\fBstd::dec\fP\fP use these functions in constructs like 'std::cin >> std::ws'\&. For more information, see the iomanip header\&. .PP Definition at line 123 of file istream\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (\fBios_base\fP &(*)(\fBios_base\fP &)__pf)\fC [inline]\fP, \fC [inherited]\fP" .PP Interface for manipulators\&. Manipulators such as \fC\fBstd::ws\fP\fP and \fC\fBstd::dec\fP\fP use these functions in constructs like 'std::cin >> std::ws'\&. For more information, see the iomanip header\&. .PP Definition at line 130 of file istream\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (bool &__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 166 of file istream\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (short &__n)\fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 114 of file istream\&.tcc\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (unsigned short &__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 173 of file istream\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (int &__n)\fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 134 of file istream\&.tcc\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (unsigned int &__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 180 of file istream\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (long &__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 184 of file istream\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (unsigned long &__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 188 of file istream\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (long long &__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 193 of file istream\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (unsigned long long &__n)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 197 of file istream\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (float &__f)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 202 of file istream\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (double &__f)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 206 of file istream\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (long double &__f)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 210 of file istream\&. .SS "template \fB__istream_type\fP& \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (void *&__p)\fC [inline]\fP, \fC [inherited]\fP" .PP Basic arithmetic extractors\&. \fBParameters:\fP .RS 4 \fIA\fP variable of builtin type\&. .RE .PP \fBReturns:\fP .RS 4 \fC*this\fP if successful .RE .PP These functions use the stream's current locale (specifically, the \fC\fBnum_get\fP\fP facet) to parse the input data\&. .PP Definition at line 214 of file istream\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::operator>> (\fB__streambuf_type\fP *__sb)\fC [inherited]\fP" .PP Extracting into another streambuf\&. \fBParameters:\fP .RS 4 \fIsb\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 \fIsb\fP is NULL, the stream will set failbit in its error state\&. .PP Characters are extracted from this stream and inserted into the \fIsb\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 Definition at line 154 of file istream\&.tcc\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits >::int_type \fBstd::basic_istream\fP< _CharT, _Traits >::peek (void)\fC [inherited]\fP" .PP Looking ahead in the stream\&. \fBReturns:\fP .RS 4 The next character, or \fBeof()\fP\&. .RE .PP If, after constructing the sentry object, \fC\fBgood()\fP\fP is false, returns \fCtraits::eof()\fP\&. Otherwise reads but does not extract the next input character\&. .PP Definition at line 570 of file istream\&.tcc\&. .SS "\fBstreamsize\fP std::ios_base::precision () const\fC [inline]\fP, \fC [inherited]\fP" .PP Flags access\&. \fBReturns:\fP .RS 4 The precision to generate on certain output operations\&. .RE .PP Be careful if you try to give a definition of 'precision' here; see DR 189\&. .PP Definition at line 625 of file ios_base\&.h\&. .PP Referenced by std::basic_ios< _CharT, _Traits >::copyfmt(), and std::operator<<()\&. .SS "\fBstreamsize\fP std::ios_base::precision (\fBstreamsize\fP__prec)\fC [inline]\fP, \fC [inherited]\fP" .PP Changing flags\&. \fBParameters:\fP .RS 4 \fIprec\fP The new precision value\&. .RE .PP \fBReturns:\fP .RS 4 The previous value of \fBprecision()\fP\&. .RE .PP .PP Definition at line 634 of file ios_base\&.h\&. .SS "template \fBbasic_ostream\fP< _CharT, _Traits > & \fBstd::basic_ostream\fP< _CharT, _Traits >::put (char_type__c)\fC [inherited]\fP" .PP Simple insertion\&. \fBParameters:\fP .RS 4 \fIc\fP The character to insert\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP Tries to insert \fIc\fP\&. .PP \fBNote:\fP .RS 4 This function is not overloaded on signed char and unsigned char\&. .RE .PP .PP Definition at line 149 of file ostream\&.tcc\&. .PP Referenced by std::endl(), and std::ends()\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::putback (char_type__c)\fC [inherited]\fP" .PP Unextracting a single character\&. \fBParameters:\fP .RS 4 \fIc\fP The character to push back into the input stream\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP If \fC\fBrdbuf()\fP\fP is not null, calls \fC\fBrdbuf()\fP->sputbackc(c)\fP\&. .PP If \fC\fBrdbuf()\fP\fP is null or if \fCsputbackc()\fP fails, sets badbit in the error state\&. .PP \fBNote:\fP .RS 4 Since no characters are extracted, the next call to \fC\fBgcount()\fP\fP will return 0, as required by DR 60\&. .RE .PP .PP Definition at line 661 of file istream\&.tcc\&. .PP References std::basic_streambuf< _CharT, _Traits >::sputbackc()\&. .PP Referenced by std::operator>>()\&. .SS "void*& std::ios_base::pword (int__ix)\fC [inline]\fP, \fC [inherited]\fP" .PP Access to void pointer array\&. \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 766 of file ios_base\&.h\&. .SS "template \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\&. \fBParameters:\fP .RS 4 \fIsb\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 \fC\fBrdbuf()\fP\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 .fi .PP .PP Definition at line 52 of file basic_ios\&.tcc\&. .SS "template \fB__filebuf_type\fP* \fBstd::basic_fstream\fP< _CharT, _Traits >::rdbuf () const\fC [inline]\fP" .PP Accessing the underlying buffer\&. \fBReturns:\fP .RS 4 The current \fBbasic_filebuf\fP buffer\&. .RE .PP This hides both signatures of \fBstd::basic_ios::rdbuf()\fP\&. .PP Reimplemented from \fBstd::basic_ios< _CharT, _Traits >\fP\&. .PP Definition at line 836 of file fstream\&. .SS "template \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\&. \fBReturns:\fP .RS 4 A bit pattern (well, isn't everything?) .RE .PP See \fBstd::ios_base::iostate\fP for the possible bit values\&. Most users will call one of the interpreting wrappers, e\&.g\&., \fBgood()\fP\&. .PP Definition at line 127 of file basic_ios\&.h\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::read (char_type *__s, \fBstreamsize\fP__n)\fC [inherited]\fP" .PP Extraction without delimiters\&. \fBParameters:\fP .RS 4 \fIs\fP A character array\&. .br \fIn\fP Maximum number of characters to store\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP If the stream state is \fC\fBgood()\fP\fP, extracts characters and stores them into \fIs\fP until one of the following happens: .IP "\(bu" 2 \fIn\fP characters are stored .IP "\(bu" 2 the input sequence reaches end-of-file, in which case the error state is set to \fCfailbit|eofbit\fP\&. .PP .PP \fBNote:\fP .RS 4 This function is not overloaded on signed char and unsigned char\&. .RE .PP .PP Definition at line 600 of file istream\&.tcc\&. .SS "template \fBstreamsize\fP \fBstd::basic_istream\fP< _CharT, _Traits >::readsome (char_type *__s, \fBstreamsize\fP__n)\fC [inherited]\fP" .PP Extraction until the buffer is exhausted, but no more\&. \fBParameters:\fP .RS 4 \fIs\fP A character array\&. .br \fIn\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 \fIs\fP depending on the number of characters remaining in the streambuf's buffer, \fC\fBrdbuf()\fP->in_avail()\fP, called \fCA\fP here: .IP "\(bu" 2 if \fCA\fP \fC==\fP \fC-1\fP, sets eofbit and extracts no characters .IP "\(bu" 2 if \fCA\fP \fC==\fP \fC0\fP, extracts no characters .IP "\(bu" 2 if \fCA\fP \fC>\fP \fC0\fP, extracts \fCmin(A,n)\fP .PP .PP The goal is to empty the current buffer, and to not request any more from the external input sequence controlled by the streambuf\&. .PP Definition at line 629 of file istream\&.tcc\&. .PP References std::min()\&. .SS "void std::ios_base::register_callback (\fBevent_callback\fP__fn, int__index)\fC [inherited]\fP" .PP Add the callback __fn with parameter __index\&. \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 \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::seekg (pos_type__pos)\fC [inherited]\fP" .PP Changing the current read position\&. \fBParameters:\fP .RS 4 \fIpos\fP A file position object\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP If \fC\fBfail()\fP\fP is not true, calls \fC\fBrdbuf()\fP->pubseekpos(pos)\fP\&. If that function fails, sets failbit\&. .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 \fC\fBgcount()\fP\fP\&. .RE .PP .PP Definition at line 787 of file istream\&.tcc\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::seekg (off_type__off, \fBios_base::seekdir\fP__dir)\fC [inherited]\fP" .PP Changing the current read position\&. \fBParameters:\fP .RS 4 \fIoff\fP A file offset object\&. .br \fIdir\fP The direction in which to seek\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP If \fC\fBfail()\fP\fP is not true, calls \fC\fBrdbuf()\fP->pubseekoff(off,dir)\fP\&. If that function fails, sets failbit\&. .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 \fC\fBgcount()\fP\fP\&. .RE .PP .PP Definition at line 820 of file istream\&.tcc\&. .SS "template \fBbasic_ostream\fP< _CharT, _Traits > & \fBstd::basic_ostream\fP< _CharT, _Traits >::seekp (pos_type__pos)\fC [inherited]\fP" .PP Changing the current write position\&. \fBParameters:\fP .RS 4 \fIpos\fP A file position object\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP If \fC\fBfail()\fP\fP is not true, calls \fC\fBrdbuf()\fP->pubseekpos(pos)\fP\&. If that function fails, sets failbit\&. .PP Definition at line 258 of file ostream\&.tcc\&. .SS "template \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\&. \fBParameters:\fP .RS 4 \fIoff\fP A file offset object\&. .br \fIdir\fP The direction in which to seek\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP If \fC\fBfail()\fP\fP is not true, calls \fC\fBrdbuf()\fP->pubseekoff(off,dir)\fP\&. If that function fails, sets failbit\&. .PP Definition at line 290 of file ostream\&.tcc\&. .SS "\fBfmtflags\fP std::ios_base::setf (\fBfmtflags\fP__fmtfl)\fC [inline]\fP, \fC [inherited]\fP" .PP Setting new format flags\&. \fBParameters:\fP .RS 4 \fIfmtfl\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 582 of file ios_base\&.h\&. .PP Referenced by std::boolalpha(), std::dec(), std::fixed(), std::hex(), std::internal(), std::left(), std::oct(), std::right(), std::scientific(), std::showbase(), std::showpoint(), std::showpos(), std::skipws(), std::unitbuf(), and std::uppercase()\&. .SS "\fBfmtflags\fP std::ios_base::setf (\fBfmtflags\fP__fmtfl, \fBfmtflags\fP__mask)\fC [inline]\fP, \fC [inherited]\fP" .PP Setting new format flags\&. \fBParameters:\fP .RS 4 \fIfmtfl\fP Additional flags to set\&. .br \fImask\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 \fC\fBios_base::adjustfield\fP\fP\&. .PP Definition at line 599 of file ios_base\&.h\&. .SS "template 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\&. \fBParameters:\fP .RS 4 \fIstate\fP The additional state flag(s) to set\&. .RE .PP See \fBstd::ios_base::iostate\fP for the possible bit values\&. .PP Definition at line 147 of file basic_ios\&.h\&. .PP Referenced by std::getline(), std::operator<<(), std::operator>>(), and std::ws()\&. .SS "template int \fBstd::basic_istream\fP< _CharT, _Traits >::sync (void)\fC [inherited]\fP" .PP Synchronizing the stream buffer\&. \fBReturns:\fP .RS 4 0 on success, -1 on failure .RE .PP If \fC\fBrdbuf()\fP\fP is a null pointer, returns -1\&. .PP Otherwise, calls \fC\fBrdbuf()\fP->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 \fC\fBgcount()\fP\fP\&. .RE .PP .PP Definition at line 727 of file istream\&.tcc\&. .PP References std::basic_streambuf< _CharT, _Traits >::pubsync()\&. .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\&. \fBParameters:\fP .RS 4 \fIsync\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 http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch28s02.html .SS "template \fBbasic_istream\fP< _CharT, _Traits >::pos_type \fBstd::basic_istream\fP< _CharT, _Traits >::tellg (void)\fC [inherited]\fP" .PP Getting the current read position\&. \fBReturns:\fP .RS 4 A file position object\&. .RE .PP If \fC\fBfail()\fP\fP is not false, returns \fCpos_type\fP(-1) to indicate failure\&. Otherwise returns \fC\fBrdbuf()\fP->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 \fC\fBgcount()\fP\fP\&. .RE .PP .PP Definition at line 763 of file istream\&.tcc\&. .SS "template \fBbasic_ostream\fP< _CharT, _Traits >::pos_type \fBstd::basic_ostream\fP< _CharT, _Traits >::tellp ()\fC [inherited]\fP" .PP Getting the current write position\&. \fBReturns:\fP .RS 4 A file position object\&. .RE .PP If \fC\fBfail()\fP\fP is not false, returns \fCpos_type\fP(-1) to indicate failure\&. Otherwise returns \fC\fBrdbuf()\fP->pubseekoff(0,cur,out)\fP\&. .PP Definition at line 237 of file ostream\&.tcc\&. .SS "template \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\&. \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, \fC\fBstd::cin\fP\fP is tied to \fC\fBstd::cout\fP\fP\&. .PP Definition at line 285 of file basic_ios\&.h\&. .PP Referenced by std::basic_ios< _CharT, _Traits >::copyfmt()\&. .SS "template \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\&. \fBParameters:\fP .RS 4 \fItiestr\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 \fBtie()\fP for more\&. .PP Definition at line 297 of file basic_ios\&.h\&. .SS "template \fBbasic_istream\fP< _CharT, _Traits > & \fBstd::basic_istream\fP< _CharT, _Traits >::unget (void)\fC [inherited]\fP" .PP Unextracting the previous character\&. \fBReturns:\fP .RS 4 *this .RE .PP If \fC\fBrdbuf()\fP\fP is not null, calls \fC\fBrdbuf()\fP->sungetc(c)\fP\&. .PP If \fC\fBrdbuf()\fP\fP is null or if \fCsungetc()\fP fails, sets badbit in the error state\&. .PP \fBNote:\fP .RS 4 Since no characters are extracted, the next call to \fC\fBgcount()\fP\fP will return 0, as required by DR 60\&. .RE .PP .PP Definition at line 694 of file istream\&.tcc\&. .PP References std::basic_streambuf< _CharT, _Traits >::sungetc()\&. .SS "void std::ios_base::unsetf (\fBfmtflags\fP__mask)\fC [inline]\fP, \fC [inherited]\fP" .PP Clearing format flags\&. \fBParameters:\fP .RS 4 \fImask\fP The flags to unset\&. .RE .PP This function clears \fImask\fP in the format flags\&. .PP Definition at line 614 of file ios_base\&.h\&. .PP Referenced by std::noboolalpha(), std::noshowbase(), std::noshowpoint(), std::noshowpos(), std::noskipws(), std::nounitbuf(), and std::nouppercase()\&. .SS "template char_type \fBstd::basic_ios\fP< _CharT, _Traits >::widen (char__c) const\fC [inline]\fP, \fC [inherited]\fP" .PP Widens characters\&. \fBParameters:\fP .RS 4 \fIc\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 >(getloc())\&.widen(c) .fi .PP .PP Additional l10n notes are at http://gcc.gnu.org/onlinedocs/libstdc++/manual/localization.html .PP Definition at line 439 of file basic_ios\&.h\&. .PP Referenced by std::endl(), std::getline(), and std::operator>>()\&. .SS "\fBstreamsize\fP std::ios_base::width () const\fC [inline]\fP, \fC [inherited]\fP" .PP Flags access\&. \fBReturns:\fP .RS 4 The minimum field width to generate on output operations\&. .RE .PP 'Minimum field width' refers to the number of characters\&. .PP Definition at line 648 of file ios_base\&.h\&. .PP Referenced by std::basic_ios< _CharT, _Traits >::copyfmt(), std::num_put< _CharT, _OutIter >::do_put(), and std::operator>>()\&. .SS "\fBstreamsize\fP std::ios_base::width (\fBstreamsize\fP__wide)\fC [inline]\fP, \fC [inherited]\fP" .PP Changing flags\&. \fBParameters:\fP .RS 4 \fIwide\fP The new width value\&. .RE .PP \fBReturns:\fP .RS 4 The previous value of \fBwidth()\fP\&. .RE .PP .PP Definition at line 657 of file ios_base\&.h\&. .SS "template \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\&. \fBParameters:\fP .RS 4 \fIs\fP The array to insert\&. .br \fIn\fP Maximum number of characters to insert\&. .RE .PP \fBReturns:\fP .RS 4 *this .RE .PP Characters are copied from \fIs\fP and inserted into the stream until one of the following happens: .PP .IP "\(bu" 2 \fIn\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 183 of file ostream\&.tcc\&. .SS "static int std::ios_base::xalloc () throw ()\fC [static]\fP, \fC [inherited]\fP" .PP Access to unique indices\&. \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 "\fBiostate\fP std::ios_base::_M_exception\fC [protected]\fP, \fC [inherited]\fP" \fBios_base\fP data members (doc me) .PP Definition at line 467 of file ios_base\&.h\&. .SS "\fBfmtflags\fP std::ios_base::_M_flags\fC [protected]\fP, \fC [inherited]\fP" \fBios_base\fP data members (doc me) .PP Definition at line 466 of file ios_base\&.h\&. .SS "template \fBstreamsize\fP \fBstd::basic_istream\fP< _CharT, _Traits >::_M_gcount\fC [protected]\fP, \fC [inherited]\fP" The number of characters extracted in the previous unformatted function; see \fBgcount()\fP\&. .PP Definition at line 79 of file istream\&. .SS "\fBstreamsize\fP std::ios_base::_M_precision\fC [protected]\fP, \fC [inherited]\fP" \fBios_base\fP data members (doc me) .PP Definition at line 464 of file ios_base\&.h\&. .SS "\fBiostate\fP std::ios_base::_M_streambuf_state\fC [protected]\fP, \fC [inherited]\fP" \fBios_base\fP data members (doc me) .PP Definition at line 468 of file ios_base\&.h\&. .SS "\fBstreamsize\fP std::ios_base::_M_width\fC [protected]\fP, \fC [inherited]\fP" \fBios_base\fP data members (doc me) .PP Definition at line 465 of file ios_base\&.h\&. .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 318 of file ios_base\&.h\&. .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 372 of file ios_base\&.h\&. .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 375 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 342 of file ios_base\&.h\&. .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 321 of file ios_base\&.h\&. .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 404 of file ios_base\&.h\&. .PP Referenced by std::basic_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 http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch27s02.html\&. .PP Definition at line 380 of file ios_base\&.h\&. .PP Referenced by std::basic_filebuf< _CharT, _Traits >::showmanyc()\&. .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 266 of file ios_base\&.h\&. .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 407 of file ios_base\&.h\&. .PP Referenced by std::basic_filebuf< _CharT, _Traits >::imbue(), std::basic_filebuf< _CharT, _Traits >::pbackfail(), and std::basic_filebuf< _CharT, _Traits >::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 269 of file ios_base\&.h\&. .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 410 of file ios_base\&.h\&. .PP Referenced by std::basic_filebuf< _CharT, _Traits >::open()\&. .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 345 of file ios_base\&.h\&. .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 350 of file ios_base\&.h\&. .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 272 of file ios_base\&.h\&. .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 324 of file ios_base\&.h\&. .SS "const \fBiostate\fP std::ios_base::goodbit\fC [static]\fP, \fC [inherited]\fP" .PP Indicates all is well\&. .PP Definition at line 353 of file ios_base\&.h\&. .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 275 of file ios_base\&.h\&. .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 383 of file ios_base\&.h\&. .PP Referenced by std::basic_filebuf< _CharT, _Traits >::pbackfail(), std::basic_filebuf< _CharT, _Traits >::showmanyc(), std::basic_filebuf< _CharT, _Traits >::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 280 of file ios_base\&.h\&. .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 284 of file ios_base\&.h\&. .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 287 of file ios_base\&.h\&. .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 386 of file ios_base\&.h\&. .PP Referenced by std::basic_filebuf< _CharT, _Traits >::overflow(), 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 291 of file ios_base\&.h\&. .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 294 of file ios_base\&.h\&. .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 298 of file ios_base\&.h\&. .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 302 of file ios_base\&.h\&. .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 305 of file ios_base\&.h\&. .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 308 of file ios_base\&.h\&. .SS "const \fBopenmode\fP std::ios_base::trunc\fC [static]\fP, \fC [inherited]\fP" .PP Open for input\&. Default for \fCofstream\fP\&. .PP Definition at line 389 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 311 of file ios_base\&.h\&. .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 315 of file ios_base\&.h\&. .SH "Author" .PP Generated automatically by Doxygen for libstdc++ from the source code\&.