num_put::put
Converts a number into a sequence of CharTypes that represents the number formatted for a given locale.
iter_type put(
iter_type _Dest,
ios_base& _Iosbase,
_Elem _Fill,
bool _Val
) const;
iter_type put(
iter_type _Dest,
ios_base& _Iosbase,
_Elem _Fill,
long _Val
) const;
iter_type put(
iter_type _Dest,
ios_base& _Iosbase,
_Elem _Fill,
unsigned long _Val
) const;
iter_type put(
iter_type _Dest,
ios_base& _Iosbase,
_Elem _Fill,
Long long _Val
) const;
iter_type put(
iter_type _Dest,
ios_base& _Iosbase,
_Elem _Fill,
Unsigned long long _Val
) const;
iter_type put(
iter_type _Dest,
ios_base& _Iosbase,
_Elem _Fill,
double _Val
) const;
iter_type put(
iter_type _Dest,
ios_base& _Iosbase,
_Elem _Fill,
long double _Val
) const;
iter_type put(
iter_type _Dest,
ios_base& _Iosbase,
_Elem _Fill,
const void * _Val
) const;
Parameters
_Dest
An iterator addressing the first element of the inserted string._Iosbase
Specified the stream that contains locale with the numpunct facet used to punctuate the output and flags for formatting the output._Fill
A character that is used for spacing._Val
The number or Boolean type that is to be output.
Return Value
An output iterator the addresses the position one beyond the last element produced.
Remarks
All member functions return do_put(_Next, _Iosbase, _Fill, _Val).
Example
// num_put_put.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
#include <sstream>
using namespace std;
int main( )
{
locale loc( "german_germany" );
basic_stringstream<char> psz2;
ios_base::iostate st = 0;
long double fVal;
cout << "The thousands separator is: "
<< use_facet < numpunct <char> >(loc).thousands_sep( )
<< endl;
psz2.imbue( loc );
use_facet < num_put < char > >
( loc ).put(basic_ostream<char>::_Iter(psz2.rdbuf( ) ),
psz2, ' ', fVal=1000.67);
if ( st & ios_base::failbit )
cout << "num_put( ) FAILED" << endl;
else
cout << "num_put( ) = " << psz2.rdbuf( )->str( ) << endl;
}
The thousands separator is: . num_put( ) = 1.000,67
Requirements
Header: <locale>
Namespace: std