.TH "std::num_put< _CharT, _OutIter >" 3cxx "libstdc++" \" -*- nroff -*- .ad l .nh .SH NAME std::num_put< _CharT, _OutIter > \- Primary class template num_put\&. .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 "\fBtypedef\fP _CharT \fBchar_type\fP" .br .RI "Public typedefs\&. " .ti -1c .RI "\fBtypedef\fP \fB_OutIter\fP \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 \fB__refs\fP=0)" .br .RI "Constructor performs initialization\&. " .ti -1c .RI "template<\fBtypename\fP \fB_ValueT\fP > \fB_OutIter\fP \fB_M_insert_float\fP (\fB_OutIter\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, _CharT __fill, char \fB__mod\fP, \fB_ValueT\fP \fB__v\fP) const" .br .ti -1c .RI "template<\fBtypename\fP \fB_ValueT\fP > \fB_OutIter\fP \fB_M_insert_int\fP (\fB_OutIter\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, _CharT __fill, \fB_ValueT\fP \fB__v\fP) const" .br .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, bool \fB__v\fP) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, const \fBvoid\fP *\fB__v\fP) 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 \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, long \fB__v\fP) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, unsigned long \fB__v\fP) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, long long \fB__v\fP) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, unsigned long long \fB__v\fP) 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 \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, double \fB__v\fP) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBiter_type\fP \fBput\fP (\fBiter_type\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, long double \fB__v\fP) const" .br .RI "Numeric formatting\&. " .in -1c .in -1c .SS "Static Public Attributes" .in +1c .ti -1c .RI "\fBstatic\fP \fBlocale::id\fP \fBid\fP" .br .RI "Numpunct facet id\&. " .in -1c .SS "Protected Member Functions" .in +1c .ti -1c .RI "\fBvirtual\fP \fB~num_put\fP ()" .br .RI "Destructor\&. " .ti -1c .RI "\fBvoid\fP \fB_M_group_float\fP (const char *\fB__grouping\fP, size_t \fB__grouping_size\fP, \fBchar_type\fP \fB__sep\fP, const \fBchar_type\fP *__p, \fBchar_type\fP *\fB__new\fP, \fBchar_type\fP *\fB__cs\fP, int &\fB__len\fP) const" .br .ti -1c .RI "\fBvoid\fP \fB_M_group_int\fP (const char *\fB__grouping\fP, size_t \fB__grouping_size\fP, \fBchar_type\fP \fB__sep\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP *\fB__new\fP, \fBchar_type\fP *\fB__cs\fP, int &\fB__len\fP) const" .br .ti -1c .RI "template<\fBtypename\fP \fB_ValueT\fP > \fBiter_type\fP \fB_M_insert_float\fP (\fBiter_type\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, char \fB__mod\fP, \fB_ValueT\fP \fB__v\fP) const" .br .ti -1c .RI "template<\fBtypename\fP \fB_ValueT\fP > \fBiter_type\fP \fB_M_insert_int\fP (\fBiter_type\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, \fB_ValueT\fP \fB__v\fP) const" .br .ti -1c .RI "\fBvoid\fP \fB_M_pad\fP (\fBchar_type\fP __fill, \fBstreamsize\fP \fB__w\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP *\fB__new\fP, const \fBchar_type\fP *\fB__cs\fP, int &\fB__len\fP) const" .br .in -1c .PP .RI "\fB\fP" .br .in +1c .in +1c .ti -1c .RI "\fBvirtual\fP \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, bool \fB__v\fP) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBvirtual\fP \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, long \fB__v\fP) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBvirtual\fP \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, unsigned long \fB__v\fP) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBvirtual\fP \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, long long \fB__v\fP) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBvirtual\fP \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP \fB__s\fP, \fBios_base\fP &\fB__io\fP, \fBchar_type\fP __fill, unsigned long long \fB__v\fP) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBvirtual\fP \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP, \fBios_base\fP &, \fBchar_type\fP, double) const" .br .RI "Numeric formatting\&. " .ti -1c .RI "\fBvirtual\fP \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 "\fBvirtual\fP \fBiter_type\fP \fBdo_put\fP (\fBiter_type\fP, \fBios_base\fP &, \fBchar_type\fP, const \fBvoid\fP *) const" .br .RI "Numeric formatting\&. " .in -1c .in -1c .SS "Static Protected Member Functions" .in +1c .ti -1c .RI "\fBstatic\fP __c_locale \fB_S_clone_c_locale\fP (__c_locale &\fB__cloc\fP) \fBthrow\fP ()" .br .ti -1c .RI "\fBstatic\fP \fBvoid\fP \fB_S_create_c_locale\fP (__c_locale &\fB__cloc\fP, const char *\fB__s\fP, __c_locale \fB__old\fP=0)" .br .ti -1c .RI "\fBstatic\fP \fBvoid\fP \fB_S_destroy_c_locale\fP (__c_locale &\fB__cloc\fP)" .br .ti -1c .RI "\fBstatic\fP __c_locale \fB_S_get_c_locale\fP ()" .br .ti -1c .RI "\fBstatic\fP const char * \fB_S_get_c_name\fP () \fBthrow\fP ()" .br .ti -1c .RI "\fBstatic\fP __c_locale \fB_S_lc_ctype_c_locale\fP (__c_locale \fB__cloc\fP, const char *\fB__s\fP)" .br .in -1c .SH "Detailed Description" .PP .SS "template<\fBtypename\fP _CharT, \fBtypename\fP \fB_OutIter\fP> .br class std::num_put< _CharT, _OutIter >"Primary class template num_put\&. This facet encapsulates the code to convert a number to a string\&. It is used by the ostream numeric insertion operators\&. .PP 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\&. .SH "Member Typedef Documentation" .PP .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBtypedef\fP _CharT \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::char_type" .PP Public typedefs\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBtypedef\fP \fB_OutIter\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::iter_type" .PP Public typedefs\&. .SH "Constructor & Destructor Documentation" .PP .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::num_put (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<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBvirtual\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::~\fBnum_put\fP ()\fC [inline]\fP, \fC [protected]\fP, \fC [virtual]\fP" .PP Destructor\&. .SH "Member Function Documentation" .PP .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fB_OutIter\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 References \fBstd::ios_base::adjustfield\fP, \fBstd::ios_base::boolalpha\fP, and \fBstd::ios_base::left\fP\&. .PP Referenced by \fBstd::num_put< _CharT, _OutIter >::put()\fP, \fBstd::num_put< _CharT, _OutIter >::put()\fP, \fBstd::num_put< _CharT, _OutIter >::put()\fP, \fBstd::num_put< _CharT, _OutIter >::put()\fP, \fBstd::num_put< _CharT, _OutIter >::put()\fP, \fBstd::num_put< _CharT, _OutIter >::put()\fP, \fBstd::num_put< _CharT, _OutIter >::put()\fP, and \fBstd::num_put< _CharT, _OutIter >::put()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBvirtual\fP \fBiter_type\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBvirtual\fP \fBiter_type\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBvirtual\fP \fBiter_type\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBvirtual\fP \fBiter_type\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fB_OutIter\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::do_put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, const \fBvoid\fP * __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 References \fBstd::ios_base::basefield\fP, \fBstd::ios_base::hex\fP, \fBstd::ios_base::showbase\fP, and \fBstd::ios_base::uppercase\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fB_OutIter\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fB_OutIter\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBiter_type\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 References \fBstd::num_put< _CharT, _OutIter >::do_put()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBiter_type\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::put (\fBiter_type\fP __s, \fBios_base\fP & __io, \fBchar_type\fP __fill, const \fBvoid\fP * __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 References \fBstd::num_put< _CharT, _OutIter >::do_put()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBiter_type\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 References \fBstd::num_put< _CharT, _OutIter >::do_put()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBiter_type\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 References \fBstd::num_put< _CharT, _OutIter >::do_put()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBiter_type\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 References \fBstd::num_put< _CharT, _OutIter >::do_put()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBiter_type\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 References \fBstd::num_put< _CharT, _OutIter >::do_put()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBiter_type\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 References \fBstd::num_put< _CharT, _OutIter >::do_put()\fP\&. .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBiter_type\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::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 References \fBstd::num_put< _CharT, _OutIter >::do_put()\fP\&. .SH "Member Data Documentation" .PP .SS "template<\fBtypename\fP _CharT , \fBtypename\fP \fB_OutIter\fP > \fBlocale::id\fP \fBstd::num_put\fP< _CharT, \fB_OutIter\fP >::id\fC [static]\fP" .PP Numpunct facet id\&. .SH "Author" .PP Generated automatically by Doxygen for libstdc++ from the source code\&.