NAME¶

std::time_get_byname - std::time_get_byname

Synopsis¶

Defined in header <locale>
template<

class CharT,
class InputIt = std::istreambuf_iterator<CharT>

> class time_get_byname : public std::time_get<CharT, InputIt>

std::time_get_byname is a std::time_get facet which encapsulates time and date
parsing rules of the locale specified at its construction.

Specializations¶

The standard library is guaranteed to provide every specialization that satisfies
the following type requirements:

* CharT is one of char and wchar_t, and
* InputIt must meet the requirements of LegacyInputIterator.

Member types¶

Member type Definition
char_type CharT
iter_type InputIt

Member functions¶

constructor constructs a new time_get_byname facet
(public member function)
destructor destroys a time_get_byname facet
(protected member function)

std::time_get_byname::time_get_byname

explicit time_get_byname( const char* name, std::size_t refs = 0 );
explicit time_get_byname( const std::string& name, std::size_t refs = (since C++11)
0 );

Constructs a new std::time_get_byname facet for a locale with name.

refs is used for resource management: if refs == 0, the implementation destroys the
facet, when the last std::locale object holding it is destroyed. Otherwise, the
object is not destroyed.

Parameters¶

name - the name of the locale
refs - the number of references that link to the facet

std::time_get_byname::~time_get_byname

protected:
~time_get_byname();

Destroys the facet.

Inherited from std::time_get

Member type Definition
char_type CharT
iter_type InputIt

Member objects¶

Member name Type
id (static) std::locale::id

Member functions¶

date_order invokes do_date_order
(public member function of std::time_get<CharT,InputIt>)
get_time invokes do_get_time
(public member function of std::time_get<CharT,InputIt>)
get_date invokes do_get_date
(public member function of std::time_get<CharT,InputIt>)
get_weekday invokes do_get_weekday
(public member function of std::time_get<CharT,InputIt>)
get_monthname invokes do_get_monthname
(public member function of std::time_get<CharT,InputIt>)
get_year invokes do_get_year
(public member function of std::time_get<CharT,InputIt>)
get invokes do_get
(C++11) (public member function of std::time_get<CharT,InputIt>)

Protected member functions¶

do_date_order obtains preferred ordering of day, month, and year
[virtual] (virtual protected member function of
std::time_get<CharT,InputIt>)
do_get_time extracts hours, minutes, and seconds from input stream
[virtual] (virtual protected member function of
std::time_get<CharT,InputIt>)
do_get_date extracts month, day, and year from input stream
[virtual] (virtual protected member function of
std::time_get<CharT,InputIt>)
do_get_weekday extracts the name of a day of the week from input stream
[virtual] (virtual protected member function of
std::time_get<CharT,InputIt>)
do_get_monthname extracts a month name from input stream
[virtual] (virtual protected member function of
std::time_get<CharT,InputIt>)
do_get_year extracts a year from input stream
[virtual] (virtual protected member function of
std::time_get<CharT,InputIt>)
extracts date/time components from input stream, according to the
do_get specified format
[virtual] (C++11) (virtual protected member function of
std::time_get<CharT,InputIt>)

Inherited from std::time_base

Type Definition
dateorder date order enumeration type, defining the values no_order, dmy, mdy, ymd,
and ydm

Example¶

This section is incomplete
Reason: no example

See also¶

time_get parses time/date values from an input character sequence into std::tm
(class template)
get_time parses a date/time value of specified format
(C++11) (function template)

Category:¶

* Todo no example