.TH "std::num_put< _CharT, _OutIter >" 3cxx "Mon May 22 2017" "libstdc++" \" -*- nroff -*- .ad l .nh .SH NAME std::num_put< _CharT, _OutIter > \- Primary class template num_put\&. .PP This facet encapsulates the code to convert a number to a string\&. It is used by the ostream numeric insertion operators\&. .SH SYNOPSIS .br .PP .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 _OutIter \fBiter_type\fP" .br .RI "Public typedefs\&. " .in -1c .in -1c .SS "Public Member Functions" .in +1c .ti -1c .RI "\fBnum_put\fP (size_t __refs=0)" .br .RI "Constructor performs initialization\&. " .ti -1c .RI "template _OutIter \fB_M_insert_float\fP (_OutIter __s, \fBios_base\fP &__io, _CharT __fill, char __mod, _ValueT __v) const" .br .ti -1c .RI "template _OutIter \fB_M_insert_int\fP (_OutIter __s, \fBios_base\fP &__io, _CharT __fill, _ValueT __v) const" .br .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, bool __v) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, const void *__v) const" .br .RI "Numeric formatting\&. " .in -1c .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, long __v) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, unsigned long __v) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, long long __v) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, unsigned long long __v) const" .br .RI "Numeric formatting\&. " .in -1c .in -1c .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, double __v) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, long double __v) const" .br .RI "Numeric formatting\&. " .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_put\fP ()" .br .RI "Destructor\&. " .ti -1c .RI "void \fB_M_group_float\fP (const char *__grouping, size_t __grouping_size, \fBchar_type\fP __sep, const \fBchar_type\fP *__p, \fBchar_type\fP *__new, \fBchar_type\fP *__cs, int &__len) const" .br .ti -1c .RI "void \fB_M_group_int\fP (const char *__grouping, size_t __grouping_size, \fBchar_type\fP __sep, \fBios_base\fP &__io, \fBchar_type\fP *__new, \fBchar_type\fP *__cs, int &__len) const" .br .ti -1c .RI "template \fBiter_type\fP \fB_M_insert_float\fP (\fBiter_type\fP, \fBios_base\fP &__io, \fBchar_type\fP __fill, char __mod, _ValueT __v) const" .br .ti -1c .RI "template \fBiter_type\fP \fB_M_insert_int\fP (\fBiter_type\fP, \fBios_base\fP &__io, \fBchar_type\fP __fill, _ValueT __v) const" .br .ti -1c .RI "void \fB_M_pad\fP (\fBchar_type\fP __fill, \fBstreamsize\fP __w, \fBios_base\fP &__io, \fBchar_type\fP *__new, const \fBchar_type\fP *__cs, int &__len) const" .br .in -1c .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "virtual \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, bool __v) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, long __v) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, unsigned long __v) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, long long __v) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP __s, \fBios_base\fP &__io, \fBchar_type\fP __fill, unsigned long long __v) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP, \fBios_base\fP &, \fBchar_type\fP, double) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP, \fBios_base\fP &, \fBchar_type\fP, long double) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "virtual \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP, \fBios_base\fP &, \fBchar_type\fP, const void *) const" .br .RI "Numeric formatting\&. " .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_put< _CharT, _OutIter >" Primary class template num_put\&. .PP This facet encapsulates the code to convert a number to a string\&. It is used by the ostream numeric insertion operators\&. The num_put 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_put facet\&. .PP Definition at line 2289 of file locale_facets\&.h\&. .SH "Member Typedef Documentation" .PP .SS "template typedef _CharT \fBstd::num_put\fP< _CharT, _OutIter >::\fBchar_type\fP" .PP Public typedefs\&. .PP Definition at line 2295 of file locale_facets\&.h\&. .SS "template typedef _OutIter \fBstd::num_put\fP< _CharT, _OutIter >::\fBiter_type\fP" .PP Public typedefs\&. .PP Definition at line 2296 of file locale_facets\&.h\&. .SH "Constructor & Destructor Documentation" .PP .SS "template \fBstd::num_put\fP< _CharT, _OutIter >::\fBnum_put\fP (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 .PP Definition at line 2310 of file locale_facets\&.h\&. .SS "template virtual \fBstd::num_put\fP< _CharT, _OutIter >::~\fBnum_put\fP ()\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Destructor\&. .PP Definition at line 2489 of file locale_facets\&.h\&. .SH "Member Function Documentation" .PP .SS "template _OutIter \fBstd::num_put\fP< _CharT, _OutIter >::do_put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, bool __v) const\fC [protected]\fP, \fC [virtual]\fP" .PP Numeric formatting\&. These functions do the work of formatting numeric values and inserting them into a stream\&. This function is a hook for derived classes to change the value returned\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 1106 of file locale_facets\&.tcc\&. .PP References std::ios_base::_M_getloc(), std::ios_base::adjustfield, std::ios_base::boolalpha, std::ios_base::flags(), std::ios_base::left, and std::ios_base::width()\&. .PP Referenced by std::num_put< _CharT, _OutIter >::do_put()\&. .SS "template virtual \fBiter_type\fP \fBstd::num_put\fP< _CharT, _OutIter >::do_put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, long __v) const\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Numeric formatting\&. These functions do the work of formatting numeric values and inserting them into a stream\&. This function is a hook for derived classes to change the value returned\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 2509 of file locale_facets\&.h\&. .SS "template virtual \fBiter_type\fP \fBstd::num_put\fP< _CharT, _OutIter >::do_put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, unsigned long __v) const\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Numeric formatting\&. These functions do the work of formatting numeric values and inserting them into a stream\&. This function is a hook for derived classes to change the value returned\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 2513 of file locale_facets\&.h\&. .SS "template virtual \fBiter_type\fP \fBstd::num_put\fP< _CharT, _OutIter >::do_put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, long long __v) const\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Numeric formatting\&. These functions do the work of formatting numeric values and inserting them into a stream\&. This function is a hook for derived classes to change the value returned\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 2519 of file locale_facets\&.h\&. .SS "template virtual \fBiter_type\fP \fBstd::num_put\fP< _CharT, _OutIter >::do_put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, unsigned long long __v) const\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Numeric formatting\&. These functions do the work of formatting numeric values and inserting them into a stream\&. This function is a hook for derived classes to change the value returned\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 2524 of file locale_facets\&.h\&. .SS "template _OutIter \fBstd::num_put\fP< _CharT, _OutIter >::do_put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, double __v) const\fC [protected]\fP, \fC [virtual]\fP" .PP Numeric formatting\&. These functions do the work of formatting numeric values and inserting them into a stream\&. This function is a hook for derived classes to change the value returned\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 1158 of file locale_facets\&.tcc\&. .PP References std::num_put< _CharT, _OutIter >::do_put()\&. .SS "template _OutIter \fBstd::num_put\fP< _CharT, _OutIter >::do_put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, long double __v) const\fC [protected]\fP, \fC [virtual]\fP" .PP Numeric formatting\&. These functions do the work of formatting numeric values and inserting them into a stream\&. This function is a hook for derived classes to change the value returned\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 1172 of file locale_facets\&.tcc\&. .PP References std::num_put< _CharT, _OutIter >::do_put()\&. .SS "template _OutIter \fBstd::num_put\fP< _CharT, _OutIter >::do_put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, const void * __v) const\fC [protected]\fP, \fC [virtual]\fP" .PP Numeric formatting\&. These functions do the work of formatting numeric values and inserting them into a stream\&. This function is a hook for derived classes to change the value returned\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 1179 of file locale_facets\&.tcc\&. .PP References std::ios_base::basefield, std::ios_base::flags(), std::ios_base::hex, std::ios_base::showbase, and std::ios_base::uppercase\&. .SS "template \fBiter_type\fP \fBstd::num_put\fP< _CharT, _OutIter >::put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, bool __v) const\fC [inline]\fP" .PP Numeric formatting\&. Formats the boolean \fIv\fP and inserts it into a stream\&. It does so by calling num_put::do_put()\&. .PP If ios_base::boolalpha is set, writes ctype::truename() or ctype::falsename()\&. Otherwise formats \fIv\fP as an int\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 2328 of file locale_facets\&.h\&. .SS "template \fBiter_type\fP \fBstd::num_put\fP< _CharT, _OutIter >::put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, long __v) const\fC [inline]\fP" .PP Numeric formatting\&. Formats the integral value \fIv\fP and inserts it into a stream\&. It does so by calling num_put::do_put()\&. .PP Formatting is affected by the flag settings in \fIio\fP\&. .PP The basic format is affected by the value of io\&.flags() & ios_base::basefield\&. If equal to ios_base::oct, formats like the printf o specifier\&. Else if equal to ios_base::hex, formats like x or X with ios_base::uppercase unset or set respectively\&. Otherwise, formats like d, ld, lld for signed and u, lu, llu for unsigned values\&. Note that if both oct and hex are set, neither will take effect\&. .PP If ios_base::showpos is set, '+' is output before positive values\&. If ios_base::showbase is set, '0' precedes octal values (except 0) and '0[xX]' precedes hex values\&. .PP The decimal point character used is numpunct::decimal_point()\&. Thousands separators are inserted according to numpunct::grouping() and numpunct::thousands_sep()\&. .PP If io\&.width() is non-zero, enough \fIfill\fP characters are inserted to make the result at least that wide\&. If (io\&.flags() & ios_base::adjustfield) == ios_base::left, result is padded at the end\&. If ios_base::internal, then padding occurs immediately after either a '+' or '-' or after '0x' or '0X'\&. Otherwise, padding occurs at the beginning\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 2370 of file locale_facets\&.h\&. .SS "template \fBiter_type\fP \fBstd::num_put\fP< _CharT, _OutIter >::put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, unsigned long __v) const\fC [inline]\fP" .PP Numeric formatting\&. Formats the integral value \fIv\fP and inserts it into a stream\&. It does so by calling num_put::do_put()\&. .PP Formatting is affected by the flag settings in \fIio\fP\&. .PP The basic format is affected by the value of io\&.flags() & ios_base::basefield\&. If equal to ios_base::oct, formats like the printf o specifier\&. Else if equal to ios_base::hex, formats like x or X with ios_base::uppercase unset or set respectively\&. Otherwise, formats like d, ld, lld for signed and u, lu, llu for unsigned values\&. Note that if both oct and hex are set, neither will take effect\&. .PP If ios_base::showpos is set, '+' is output before positive values\&. If ios_base::showbase is set, '0' precedes octal values (except 0) and '0[xX]' precedes hex values\&. .PP The decimal point character used is numpunct::decimal_point()\&. Thousands separators are inserted according to numpunct::grouping() and numpunct::thousands_sep()\&. .PP If io\&.width() is non-zero, enough \fIfill\fP characters are inserted to make the result at least that wide\&. If (io\&.flags() & ios_base::adjustfield) == ios_base::left, result is padded at the end\&. If ios_base::internal, then padding occurs immediately after either a '+' or '-' or after '0x' or '0X'\&. Otherwise, padding occurs at the beginning\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 2374 of file locale_facets\&.h\&. .SS "template \fBiter_type\fP \fBstd::num_put\fP< _CharT, _OutIter >::put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, long long __v) const\fC [inline]\fP" .PP Numeric formatting\&. Formats the integral value \fIv\fP and inserts it into a stream\&. It does so by calling num_put::do_put()\&. .PP Formatting is affected by the flag settings in \fIio\fP\&. .PP The basic format is affected by the value of io\&.flags() & ios_base::basefield\&. If equal to ios_base::oct, formats like the printf o specifier\&. Else if equal to ios_base::hex, formats like x or X with ios_base::uppercase unset or set respectively\&. Otherwise, formats like d, ld, lld for signed and u, lu, llu for unsigned values\&. Note that if both oct and hex are set, neither will take effect\&. .PP If ios_base::showpos is set, '+' is output before positive values\&. If ios_base::showbase is set, '0' precedes octal values (except 0) and '0[xX]' precedes hex values\&. .PP The decimal point character used is numpunct::decimal_point()\&. Thousands separators are inserted according to numpunct::grouping() and numpunct::thousands_sep()\&. .PP If io\&.width() is non-zero, enough \fIfill\fP characters are inserted to make the result at least that wide\&. If (io\&.flags() & ios_base::adjustfield) == ios_base::left, result is padded at the end\&. If ios_base::internal, then padding occurs immediately after either a '+' or '-' or after '0x' or '0X'\&. Otherwise, padding occurs at the beginning\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 2380 of file locale_facets\&.h\&. .SS "template \fBiter_type\fP \fBstd::num_put\fP< _CharT, _OutIter >::put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, unsigned long long __v) const\fC [inline]\fP" .PP Numeric formatting\&. Formats the integral value \fIv\fP and inserts it into a stream\&. It does so by calling num_put::do_put()\&. .PP Formatting is affected by the flag settings in \fIio\fP\&. .PP The basic format is affected by the value of io\&.flags() & ios_base::basefield\&. If equal to ios_base::oct, formats like the printf o specifier\&. Else if equal to ios_base::hex, formats like x or X with ios_base::uppercase unset or set respectively\&. Otherwise, formats like d, ld, lld for signed and u, lu, llu for unsigned values\&. Note that if both oct and hex are set, neither will take effect\&. .PP If ios_base::showpos is set, '+' is output before positive values\&. If ios_base::showbase is set, '0' precedes octal values (except 0) and '0[xX]' precedes hex values\&. .PP The decimal point character used is numpunct::decimal_point()\&. Thousands separators are inserted according to numpunct::grouping() and numpunct::thousands_sep()\&. .PP If io\&.width() is non-zero, enough \fIfill\fP characters are inserted to make the result at least that wide\&. If (io\&.flags() & ios_base::adjustfield) == ios_base::left, result is padded at the end\&. If ios_base::internal, then padding occurs immediately after either a '+' or '-' or after '0x' or '0X'\&. Otherwise, padding occurs at the beginning\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 2384 of file locale_facets\&.h\&. .SS "template \fBiter_type\fP \fBstd::num_put\fP< _CharT, _OutIter >::put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, double __v) const\fC [inline]\fP" .PP Numeric formatting\&. Formats the floating point value \fIv\fP and inserts it into a stream\&. It does so by calling num_put::do_put()\&. .PP Formatting is affected by the flag settings in \fIio\fP\&. .PP The basic format is affected by the value of io\&.flags() & ios_base::floatfield\&. If equal to ios_base::fixed, formats like the printf f specifier\&. Else if equal to ios_base::scientific, formats like e or E with ios_base::uppercase unset or set respectively\&. Otherwise, formats like g or G depending on uppercase\&. Note that if both fixed and scientific are set, the effect will also be like g or G\&. .PP The output precision is given by io\&.precision()\&. This precision is capped at numeric_limits::digits10 + 2 (different for double and long double)\&. The default precision is 6\&. .PP If ios_base::showpos is set, '+' is output before positive values\&. If ios_base::showpoint is set, a decimal point will always be output\&. .PP The decimal point character used is numpunct::decimal_point()\&. Thousands separators are inserted according to numpunct::grouping() and numpunct::thousands_sep()\&. .PP If io\&.width() is non-zero, enough \fIfill\fP characters are inserted to make the result at least that wide\&. If (io\&.flags() & ios_base::adjustfield) == ios_base::left, result is padded at the end\&. If ios_base::internal, then padding occurs immediately after either a '+' or '-' or after '0x' or '0X'\&. Otherwise, padding occurs at the beginning\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 2433 of file locale_facets\&.h\&. .SS "template \fBiter_type\fP \fBstd::num_put\fP< _CharT, _OutIter >::put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, long double __v) const\fC [inline]\fP" .PP Numeric formatting\&. Formats the floating point value \fIv\fP and inserts it into a stream\&. It does so by calling num_put::do_put()\&. .PP Formatting is affected by the flag settings in \fIio\fP\&. .PP The basic format is affected by the value of io\&.flags() & ios_base::floatfield\&. If equal to ios_base::fixed, formats like the printf f specifier\&. Else if equal to ios_base::scientific, formats like e or E with ios_base::uppercase unset or set respectively\&. Otherwise, formats like g or G depending on uppercase\&. Note that if both fixed and scientific are set, the effect will also be like g or G\&. .PP The output precision is given by io\&.precision()\&. This precision is capped at numeric_limits::digits10 + 2 (different for double and long double)\&. The default precision is 6\&. .PP If ios_base::showpos is set, '+' is output before positive values\&. If ios_base::showpoint is set, a decimal point will always be output\&. .PP The decimal point character used is numpunct::decimal_point()\&. Thousands separators are inserted according to numpunct::grouping() and numpunct::thousands_sep()\&. .PP If io\&.width() is non-zero, enough \fIfill\fP characters are inserted to make the result at least that wide\&. If (io\&.flags() & ios_base::adjustfield) == ios_base::left, result is padded at the end\&. If ios_base::internal, then padding occurs immediately after either a '+' or '-' or after '0x' or '0X'\&. Otherwise, padding occurs at the beginning\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 2437 of file locale_facets\&.h\&. .SS "template \fBiter_type\fP \fBstd::num_put\fP< _CharT, _OutIter >::put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, const void * __v) const\fC [inline]\fP" .PP Numeric formatting\&. Formats the pointer value \fIv\fP and inserts it into a stream\&. It does so by calling num_put::do_put()\&. .PP This function formats \fIv\fP as an unsigned long with ios_base::hex and ios_base::showbase set\&. .PP \fBParameters:\fP .RS 4 \fI__s\fP Stream to write to\&. .br \fI__io\fP Source of locale and flags\&. .br \fI__fill\fP Char_type to use for filling\&. .br \fI__v\fP Value to format and insert\&. .RE .PP \fBReturns:\fP .RS 4 Iterator after writing\&. .RE .PP .PP Definition at line 2458 of file locale_facets\&.h\&. .SH "Member Data Documentation" .PP .SS "template \fBlocale::id\fP \fBstd::num_put\fP< _CharT, _OutIter >::id\fC [static]\fP" .PP Numpunct facet id\&. .PP Definition at line 2300 of file locale_facets\&.h\&. .SH "Author" .PP Generated automatically by Doxygen for libstdc++ from the source code\&.