num_put::put

iter_type put (iter_type out, ios_base& str, char_type fill, bool val) const;
iter_type put (iter_type out, ios_base& str, char_type fill, long val) const;
iter_type put (iter_type out, ios_base& str, char_type fill, unsigned long val) const;
iter_type put (iter_type out, ios_base& str, char_type fill, double val) const;
iter_type put (iter_type out, ios_base& str, char_type fill, long double val) const;
iter_type put (iter_type out, ios_base& str, char_type fill, const void* val) const;

Put numerical value

Parameters

out

Iterator pointing to the first character of the output sequence.
The sequence shall be large enough to contain the whole expression.
iter_type is a member alias of the second template parameter of time_put (i.e., the facet's iterator type). This can be any output iterator. By default, this is an ostreambuf_iterator, allowing implicit conversions from ostream objects such as cout.

str

Object of a class derived from ios_base (generally an output stream object). It is only used to obtain formatting information.

fill

Fill character. The fill character is used in output insertion operations to fill spaces when results have to be padded to the field width.
char_type is a member alias of the first template parameter of num_put (i.e., the facet's character type).

[/dd]

val

Value to be formatted.

Return value

Example

// num_put example
#include <iostream>
#include <locale>
using namespace std;
int main ()
{
  use_facet<num_put<char> >(cout.getloc()).put (cout, cout, '0', 3.14159265);
  cout << endl;
  return 0;
} 

3.14159

See also