class template


template <class charT, class InputIterator = istreambuf_iterator<charT> > class num_get;
Facet to parse numeric values

The num_get standard facet parses sequences of character to obtain numerical values. Its member get is called by standard input streams (such as istream) to obtain formatted numerical values with the extraction operator (operator>>).

The num_get 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_get class template (as part of the numeric category):
facets in locale objectsnotes
num_get<char>narrow characters (used by istream)
num_get<wchar_t>wide characters (used by wistream)

Template parameters

Character type: the type of the characters in the sequence to interpret.
Aliased as member char_type.
Input iterator type that points to the elements in the character sequence to interpret.
Defaults to istreambuf_iterator, which is an iterator that can be implicitly converted from basic_istream objects.
Aliased as member iter_type.

Member types

member typedefinitiondescription
char_typeThe first template parameter (charT)Character type
iter_typeThe second template parameter (InputIterator)Iterator type.
Defaults to istreambuf_iterator<charT>

Member constants

The class contains a public static constant of type locale::id that uniquely identifies facets with num_get semantics.

Public member functions

Virtual protected member functions


At least the following specializations and partial specializations of this template are provided in all library implementations:
template <class InputIterator> num_get<char,InputIterator>
template <class InputIterator> num_get<wchar_t,InputIterator>

Where InputIterator shall be a type that satisfies the requirements of an input iterator able to iterate over elements of the specified character type.