std::num_put::put

Parameters

out

Iterator pointing to the first character where the representation as a sequence of characters is stored.
The sequence shall be long enough to contain the whole expression.
Member type iter_type is the facet's iterator type (defined as an alias of num_put's second template parameter, OutputIterator). By default, this is an ostreambuf_iterator, allowing implicit conversions from basic_ostream objects.

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.
Member type char_type is the facet's character type (defined as an alias of num_put's first template parameter, charT).

val

Value to be formatted.

Return value

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

// num_put example
#include <iostream>       // std::cout
#include <locale>         // std::locale, std::num_put, std::use_facet
int main ()
{
  std::cout.width(10);    // set field width to 10 characters
  std::use_facet<std::num_put<char> >(std::cout.getloc()).put
    (std::cout, std::cout, '0', 3.14159265);
  std::cout << '\n';
  return 0;
}

0003.14159

Data races

Exception safety

See also

num_get::get

Get numeric value (public member function)

ostream::operator<<

Insert formatted output (public member function)