.TH "std::num_get< _CharT, _InIter >" 3cxx "Tue Jul 18 2023" "libstdc++" \" -*- nroff -*- .ad l .nh .SH NAME std::num_get< _CharT, _InIter > \- Primary class template num_get\&. .SH SYNOPSIS .br .PP .PP \fC#include \fP .PP Inherits \fBstd::locale::facet\fP\&. .SS "Public Types" .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "typedef _CharT \fBchar_type\fP" .br .RI "Public typedefs\&. " .ti -1c .RI "typedef _InIter \fBiter_type\fP" .br .RI "Public typedefs\&. " .in -1c .in -1c .SS "Public Member Functions" .in +1c .ti -1c .RI "\fBnum_get\fP (size_t __refs=0)" .br .RI "Constructor performs initialization\&. " .ti -1c .RI "template _GLIBCXX_DEFAULT_ABI_TAG _InIter \fB_M_extract_int\fP (_InIter __beg, _InIter __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, _ValueT &__v) const" .br .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, bool &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, void *&__v) const" .br .RI "Numeric parsing\&. " .in -1c .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, long &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, unsigned short &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, unsigned int &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, unsigned long &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, long long &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, unsigned long long &__v) const" .br .RI "Numeric parsing\&. " .in -1c .in -1c .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, float &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, double &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "\fBiter_type\fP \fBget\fP (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, long double &__v) const" .br .RI "Numeric parsing\&. " .in -1c .in -1c .SS "Static Public Attributes" .in +1c .ti -1c .RI "static \fBlocale::id\fP \fBid\fP" .br .RI "Numpunct facet id\&. " .in -1c .SS "Protected Member Functions" .in +1c .ti -1c .RI "virtual \fB~num_get\fP ()" .br .RI "Destructor\&. " .ti -1c .RI "_GLIBCXX_DEFAULT_ABI_TAG \fBiter_type\fP \fB_M_extract_float\fP (\fBiter_type\fP, \fBiter_type\fP, \fBios_base\fP &, \fBios_base::iostate\fP &, \fBstring\fP &) const" .br .ti -1c .RI "template _GLIBCXX_DEFAULT_ABI_TAG \fBiter_type\fP \fB_M_extract_int\fP (\fBiter_type\fP, \fBiter_type\fP, \fBios_base\fP &, \fBios_base::iostate\fP &, _ValueT &) const" .br .ti -1c .RI "template __gnu_cxx::__enable_if< __is_char< _CharT2 >::__value, int >::__type \fB_M_find\fP (const _CharT2 *, size_t __len, _CharT2 __c) const" .br .ti -1c .RI "template __gnu_cxx::__enable_if::__value, int >::__type \fB_M_find\fP (const _CharT2 *__zero, size_t __len, _CharT2 __c) const" .br .in -1c .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP, \fBiter_type\fP, \fBios_base\fP &, \fBios_base::iostate\fP &, bool &) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, long &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, unsigned short &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, unsigned int &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, unsigned long &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, long long &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP &__io, \fBios_base::iostate\fP &__err, unsigned long long &__v) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP, \fBiter_type\fP, \fBios_base\fP &, \fBios_base::iostate\fP &, float &) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP, \fBiter_type\fP, \fBios_base\fP &, \fBios_base::iostate\fP &, double &) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP, \fBiter_type\fP, \fBios_base\fP &, \fBios_base::iostate\fP &, long double &) const" .br .RI "Numeric parsing\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_get\fP (\fBiter_type\fP, \fBiter_type\fP, \fBios_base\fP &, \fBios_base::iostate\fP &, void *&) const" .br .RI "Numeric parsing\&. " .in -1c .in -1c .SS "Static Protected Member Functions" .in +1c .ti -1c .RI "static __c_locale \fB_S_clone_c_locale\fP (__c_locale &__cloc) throw ()" .br .ti -1c .RI "static void \fB_S_create_c_locale\fP (__c_locale &__cloc, const char *__s, __c_locale __old=0)" .br .ti -1c .RI "static void \fB_S_destroy_c_locale\fP (__c_locale &__cloc)" .br .ti -1c .RI "static __c_locale \fB_S_get_c_locale\fP ()" .br .ti -1c .RI "static const char * \fB_S_get_c_name\fP () throw ()" .br .ti -1c .RI "static __c_locale \fB_S_lc_ctype_c_locale\fP (__c_locale __cloc, const char *__s)" .br .in -1c .SH "Detailed Description" .PP .SS "template .br class std::num_get< _CharT, _InIter >"Primary class template num_get\&. This facet encapsulates the code to parse and return a number from a string\&. It is used by the istream numeric extraction operators\&. .PP The num_get template uses protected virtual functions to provide the actual results\&. The public accessors forward the call to the virtual functions\&. These virtual functions are hooks for developers to implement the behavior they require from the num_get facet\&. .SH "Member Typedef Documentation" .PP .SS "template typedef _CharT \fBstd::num_get\fP< _CharT, _InIter >::char_type" .PP Public typedefs\&. .SS "template typedef _InIter \fBstd::num_get\fP< _CharT, _InIter >::iter_type" .PP Public typedefs\&. .SH "Constructor & Destructor Documentation" .PP .SS "template \fBstd::num_get\fP< _CharT, _InIter >::num_get (size_t __refs = \fC0\fP)\fC [inline]\fP, \fC [explicit]\fP" .PP Constructor performs initialization\&. This is the constructor provided by the standard\&. .PP \fBParameters\fP .RS 4 \fI__refs\fP Passed to the base facet class\&. .RE .PP .SS "template virtual \fBstd::num_get\fP< _CharT, _InIter >::~\fBnum_get\fP ()\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Destructor\&. .SH "Member Function Documentation" .PP .SS "template virtual \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::do_get (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, long & __v) const\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Numeric parsing\&. Parses the input stream into the variable \fIv\fP\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get() for more details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .SS "template virtual \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::do_get (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, long long & __v) const\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Numeric parsing\&. Parses the input stream into the variable \fIv\fP\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get() for more details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .SS "template virtual \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::do_get (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, unsigned int & __v) const\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Numeric parsing\&. Parses the input stream into the variable \fIv\fP\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get() for more details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .SS "template virtual \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::do_get (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, unsigned long & __v) const\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Numeric parsing\&. Parses the input stream into the variable \fIv\fP\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get() for more details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .SS "template virtual \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::do_get (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, unsigned long long & __v) const\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Numeric parsing\&. Parses the input stream into the variable \fIv\fP\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get() for more details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .SS "template virtual \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::do_get (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, unsigned short & __v) const\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Numeric parsing\&. Parses the input stream into the variable \fIv\fP\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get() for more details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .SS "template _InIter \fBstd::num_get\fP< _CharT, _InIter >::do_get (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, bool & __v) const\fC [protected]\fP, \fC [virtual]\fP" .PP Numeric parsing\&. Parses the input stream into the variable \fIv\fP\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get() for more details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::ios_base::_M_getloc()\fP, \fBstd::ios_base::boolalpha\fP, \fBstd::ios_base::eofbit\fP, \fBstd::ios_base::failbit\fP, \fBstd::ios_base::flags()\fP, and \fBstd::ios_base::goodbit\fP\&. .PP Referenced by \fBstd::num_get< _CharT, _InIter >::get()\fP\&. .SS "template _InIter \fBstd::num_get\fP< _CharT, _InIter >::do_get (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, double & __v) const\fC [protected]\fP, \fC [virtual]\fP" .PP Numeric parsing\&. Parses the input stream into the variable \fIv\fP\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get() for more details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::c_str()\fP, \fBstd::ios_base::eofbit\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::reserve()\fP\&. .SS "template _InIter \fBstd::num_get\fP< _CharT, _InIter >::do_get (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, float & __v) const\fC [protected]\fP, \fC [virtual]\fP" .PP Numeric parsing\&. Parses the input stream into the variable \fIv\fP\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get() for more details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::c_str()\fP, \fBstd::ios_base::eofbit\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::reserve()\fP\&. .SS "template _InIter \fBstd::num_get\fP< _CharT, _InIter >::do_get (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, long double & __v) const\fC [protected]\fP, \fC [virtual]\fP" .PP Numeric parsing\&. Parses the input stream into the variable \fIv\fP\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get() for more details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::basic_string< _CharT, _Traits, _Alloc >::c_str()\fP, \fBstd::ios_base::eofbit\fP, and \fBstd::basic_string< _CharT, _Traits, _Alloc >::reserve()\fP\&. .SS "template _InIter \fBstd::num_get\fP< _CharT, _InIter >::do_get (\fBiter_type\fP __beg, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, void *& __v) const\fC [protected]\fP, \fC [virtual]\fP" .PP Numeric parsing\&. Parses the input stream into the variable \fIv\fP\&. This function is a hook for derived classes to change the value returned\&. .PP \fBSee also\fP .RS 4 get() for more details\&. .RE .PP \fBParameters\fP .RS 4 \fI__beg\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::ios_base::basefield\fP, \fBstd::ios_base::flags()\fP, and \fBstd::ios_base::hex\fP\&. .SS "template \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, bool & __v) const\fC [inline]\fP" .PP Numeric parsing\&. Parses the input stream into the bool \fIv\fP\&. It does so by calling num_get::do_get()\&. .PP If ios_base::boolalpha is set, attempts to read ctype::truename() or ctype::falsename()\&. Sets \fIv\fP to true or false if successful\&. Sets err to ios_base::failbit if reading the string fails\&. Sets err to ios_base::eofbit if the stream is emptied\&. .PP If ios_base::boolalpha is not set, proceeds as with reading a long, except if the value is 1, sets \fIv\fP to true, if the value is 0, sets \fIv\fP to false, and otherwise set err to ios_base::failbit\&. .PP \fBParameters\fP .RS 4 \fI__in\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::num_get< _CharT, _InIter >::do_get()\fP\&. .SS "template \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, double & __v) const\fC [inline]\fP" .PP Numeric parsing\&. Parses the input stream into the integral variable \fIv\fP\&. It does so by calling num_get::do_get()\&. .PP The input characters are parsed like the scanf g specifier\&. The matching type length modifier is also used\&. .PP The decimal point character used is numpunct::decimal_point()\&. Digit grouping is interpreted according to numpunct::grouping() and numpunct::thousands_sep()\&. If the pattern of digit groups isn't consistent, sets err to ios_base::failbit\&. .PP If parsing the string yields a valid value for \fIv\fP, \fIv\fP is set\&. Otherwise, sets err to ios_base::failbit and leaves \fIv\fP unaltered\&. Sets err to ios_base::eofbit if the stream is emptied\&. .PP \fBParameters\fP .RS 4 \fI__in\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::num_get< _CharT, _InIter >::do_get()\fP\&. .SS "template \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, float & __v) const\fC [inline]\fP" .PP Numeric parsing\&. Parses the input stream into the integral variable \fIv\fP\&. It does so by calling num_get::do_get()\&. .PP The input characters are parsed like the scanf g specifier\&. The matching type length modifier is also used\&. .PP The decimal point character used is numpunct::decimal_point()\&. Digit grouping is interpreted according to numpunct::grouping() and numpunct::thousands_sep()\&. If the pattern of digit groups isn't consistent, sets err to ios_base::failbit\&. .PP If parsing the string yields a valid value for \fIv\fP, \fIv\fP is set\&. Otherwise, sets err to ios_base::failbit and leaves \fIv\fP unaltered\&. Sets err to ios_base::eofbit if the stream is emptied\&. .PP \fBParameters\fP .RS 4 \fI__in\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::num_get< _CharT, _InIter >::do_get()\fP\&. .SS "template \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, long & __v) const\fC [inline]\fP" .PP Numeric parsing\&. Parses the input stream into the integral variable \fIv\fP\&. It does so by calling num_get::do_get()\&. .PP Parsing is affected by the flag settings in \fIio\fP\&. .PP The basic parse is affected by the value of io\&.flags() & ios_base::basefield\&. If equal to ios_base::oct, parses like the scanf o specifier\&. Else if equal to ios_base::hex, parses like X specifier\&. Else if basefield equal to 0, parses like the i specifier\&. Otherwise, parses like d for signed and u for unsigned types\&. The matching type length modifier is also used\&. .PP Digit grouping is interpreted according to numpunct::grouping() and numpunct::thousands_sep()\&. If the pattern of digit groups isn't consistent, sets err to ios_base::failbit\&. .PP If parsing the string yields a valid value for \fIv\fP, \fIv\fP is set\&. Otherwise, sets err to ios_base::failbit and leaves \fIv\fP unaltered\&. Sets err to ios_base::eofbit if the stream is emptied\&. .PP \fBParameters\fP .RS 4 \fI__in\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::num_get< _CharT, _InIter >::do_get()\fP\&. .SS "template \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, long double & __v) const\fC [inline]\fP" .PP Numeric parsing\&. Parses the input stream into the integral variable \fIv\fP\&. It does so by calling num_get::do_get()\&. .PP The input characters are parsed like the scanf g specifier\&. The matching type length modifier is also used\&. .PP The decimal point character used is numpunct::decimal_point()\&. Digit grouping is interpreted according to numpunct::grouping() and numpunct::thousands_sep()\&. If the pattern of digit groups isn't consistent, sets err to ios_base::failbit\&. .PP If parsing the string yields a valid value for \fIv\fP, \fIv\fP is set\&. Otherwise, sets err to ios_base::failbit and leaves \fIv\fP unaltered\&. Sets err to ios_base::eofbit if the stream is emptied\&. .PP \fBParameters\fP .RS 4 \fI__in\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::num_get< _CharT, _InIter >::do_get()\fP\&. .SS "template \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, long long & __v) const\fC [inline]\fP" .PP Numeric parsing\&. Parses the input stream into the integral variable \fIv\fP\&. It does so by calling num_get::do_get()\&. .PP Parsing is affected by the flag settings in \fIio\fP\&. .PP The basic parse is affected by the value of io\&.flags() & ios_base::basefield\&. If equal to ios_base::oct, parses like the scanf o specifier\&. Else if equal to ios_base::hex, parses like X specifier\&. Else if basefield equal to 0, parses like the i specifier\&. Otherwise, parses like d for signed and u for unsigned types\&. The matching type length modifier is also used\&. .PP Digit grouping is interpreted according to numpunct::grouping() and numpunct::thousands_sep()\&. If the pattern of digit groups isn't consistent, sets err to ios_base::failbit\&. .PP If parsing the string yields a valid value for \fIv\fP, \fIv\fP is set\&. Otherwise, sets err to ios_base::failbit and leaves \fIv\fP unaltered\&. Sets err to ios_base::eofbit if the stream is emptied\&. .PP \fBParameters\fP .RS 4 \fI__in\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::num_get< _CharT, _InIter >::do_get()\fP\&. .SS "template \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, unsigned int & __v) const\fC [inline]\fP" .PP Numeric parsing\&. Parses the input stream into the integral variable \fIv\fP\&. It does so by calling num_get::do_get()\&. .PP Parsing is affected by the flag settings in \fIio\fP\&. .PP The basic parse is affected by the value of io\&.flags() & ios_base::basefield\&. If equal to ios_base::oct, parses like the scanf o specifier\&. Else if equal to ios_base::hex, parses like X specifier\&. Else if basefield equal to 0, parses like the i specifier\&. Otherwise, parses like d for signed and u for unsigned types\&. The matching type length modifier is also used\&. .PP Digit grouping is interpreted according to numpunct::grouping() and numpunct::thousands_sep()\&. If the pattern of digit groups isn't consistent, sets err to ios_base::failbit\&. .PP If parsing the string yields a valid value for \fIv\fP, \fIv\fP is set\&. Otherwise, sets err to ios_base::failbit and leaves \fIv\fP unaltered\&. Sets err to ios_base::eofbit if the stream is emptied\&. .PP \fBParameters\fP .RS 4 \fI__in\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::num_get< _CharT, _InIter >::do_get()\fP\&. .SS "template \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, unsigned long & __v) const\fC [inline]\fP" .PP Numeric parsing\&. Parses the input stream into the integral variable \fIv\fP\&. It does so by calling num_get::do_get()\&. .PP Parsing is affected by the flag settings in \fIio\fP\&. .PP The basic parse is affected by the value of io\&.flags() & ios_base::basefield\&. If equal to ios_base::oct, parses like the scanf o specifier\&. Else if equal to ios_base::hex, parses like X specifier\&. Else if basefield equal to 0, parses like the i specifier\&. Otherwise, parses like d for signed and u for unsigned types\&. The matching type length modifier is also used\&. .PP Digit grouping is interpreted according to numpunct::grouping() and numpunct::thousands_sep()\&. If the pattern of digit groups isn't consistent, sets err to ios_base::failbit\&. .PP If parsing the string yields a valid value for \fIv\fP, \fIv\fP is set\&. Otherwise, sets err to ios_base::failbit and leaves \fIv\fP unaltered\&. Sets err to ios_base::eofbit if the stream is emptied\&. .PP \fBParameters\fP .RS 4 \fI__in\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::num_get< _CharT, _InIter >::do_get()\fP\&. .SS "template \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, unsigned long long & __v) const\fC [inline]\fP" .PP Numeric parsing\&. Parses the input stream into the integral variable \fIv\fP\&. It does so by calling num_get::do_get()\&. .PP Parsing is affected by the flag settings in \fIio\fP\&. .PP The basic parse is affected by the value of io\&.flags() & ios_base::basefield\&. If equal to ios_base::oct, parses like the scanf o specifier\&. Else if equal to ios_base::hex, parses like X specifier\&. Else if basefield equal to 0, parses like the i specifier\&. Otherwise, parses like d for signed and u for unsigned types\&. The matching type length modifier is also used\&. .PP Digit grouping is interpreted according to numpunct::grouping() and numpunct::thousands_sep()\&. If the pattern of digit groups isn't consistent, sets err to ios_base::failbit\&. .PP If parsing the string yields a valid value for \fIv\fP, \fIv\fP is set\&. Otherwise, sets err to ios_base::failbit and leaves \fIv\fP unaltered\&. Sets err to ios_base::eofbit if the stream is emptied\&. .PP \fBParameters\fP .RS 4 \fI__in\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::num_get< _CharT, _InIter >::do_get()\fP\&. .SS "template \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, unsigned short & __v) const\fC [inline]\fP" .PP Numeric parsing\&. Parses the input stream into the integral variable \fIv\fP\&. It does so by calling num_get::do_get()\&. .PP Parsing is affected by the flag settings in \fIio\fP\&. .PP The basic parse is affected by the value of io\&.flags() & ios_base::basefield\&. If equal to ios_base::oct, parses like the scanf o specifier\&. Else if equal to ios_base::hex, parses like X specifier\&. Else if basefield equal to 0, parses like the i specifier\&. Otherwise, parses like d for signed and u for unsigned types\&. The matching type length modifier is also used\&. .PP Digit grouping is interpreted according to numpunct::grouping() and numpunct::thousands_sep()\&. If the pattern of digit groups isn't consistent, sets err to ios_base::failbit\&. .PP If parsing the string yields a valid value for \fIv\fP, \fIv\fP is set\&. Otherwise, sets err to ios_base::failbit and leaves \fIv\fP unaltered\&. Sets err to ios_base::eofbit if the stream is emptied\&. .PP \fBParameters\fP .RS 4 \fI__in\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::num_get< _CharT, _InIter >::do_get()\fP\&. .SS "template \fBiter_type\fP \fBstd::num_get\fP< _CharT, _InIter >::get (\fBiter_type\fP __in, \fBiter_type\fP __end, \fBios_base\fP & __io, \fBios_base::iostate\fP & __err, void *& __v) const\fC [inline]\fP" .PP Numeric parsing\&. Parses the input stream into the pointer variable \fIv\fP\&. It does so by calling num_get::do_get()\&. .PP The input characters are parsed like the scanf p specifier\&. .PP Digit grouping is interpreted according to numpunct::grouping() and numpunct::thousands_sep()\&. If the pattern of digit groups isn't consistent, sets err to ios_base::failbit\&. .PP Note that the digit grouping effect for pointers is a bit ambiguous in the standard and shouldn't be relied on\&. See DR 344\&. .PP If parsing the string yields a valid value for \fIv\fP, \fIv\fP is set\&. Otherwise, sets err to ios_base::failbit and leaves \fIv\fP unaltered\&. Sets err to ios_base::eofbit if the stream is emptied\&. .PP \fBParameters\fP .RS 4 \fI__in\fP Start of input stream\&. .br \fI__end\fP End of input stream\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__err\fP Error flags to set\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns\fP .RS 4 Iterator after reading\&. .RE .PP .PP References \fBstd::num_get< _CharT, _InIter >::do_get()\fP\&. .SH "Member Data Documentation" .PP .SS "template \fBlocale::id\fP \fBstd::num_get\fP< _CharT, _InIter >::id\fC [static]\fP" .PP Numpunct facet id\&. .SH "Author" .PP Generated automatically by Doxygen for libstdc++ from the source code\&.