class template
<locale>
std::num_put
template <class charT, class OutputIterator = ostreambuf_iterator<charT> > class num_put;
Facet to format numeric values
The num_put standard facet formats numeric values as sequences of characters. Its member put is called by standard output streams (such as ostream ) to format numerical values inserted with the insertion operator (operator<< ).
The num_put class template has a protected destructor: Programs shall only construct objects of derived classes, or use those installed in locale objects (through use_facet ).
All standard locale objects support at least the following facet instantiations of the num_put class template (as part of the numeric category):
| facets in locale objects | notes |
|---|
num_put<char> | narrow characters (used by ostream ) |
num_put<wchar_t> | wide characters (used by wostream ) |
Template parameters
- charT
- Character type: the type of the characters in the sequence to write.
Aliased as member char_type.
- OutputIterator
- Output iterator type that points to the elements in the character sequence to write.
Defaults to ostreambuf_iterator , which is an iterator that can be implicitly converted from basic_ostream objects.
Aliased as member iter_type.
Member types
| member type | definition | description |
|---|
| char_type | The first template parameter (charT) | Character type |
| iter_type | The second template parameter (OutputIterator) | Iterator type.
Defaults to ostreambuf_iterator<charT> |
Member constants
The class contains a public static constant of type locale::id that uniquely identifies facets with num_put semantics.
Public member functions
- (constructor)
- num_put constructor (public member function)
- put
- Put numerical value (public member function)
Virtual protected member functions
- do_put
- Put numerical value [virtual] (protected virtual member function)
- (destructor)
- num_put destructor (protected member function)
Specializations
At least the following specializations and partial specializations of this template are provided in all library implementations:
| specialization |
|---|
num_put<char> |
num_put<wchar_t> |
template <class OutputIterator> num_put<char,OutputIterator> |
template <class OutputIterator> num_put<wchar_t,OutputIterator> |
Where OutputIterator shall be a type that satisfies the requirements of an output iterator able to iterate over elements of the specified character type.