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.

Two specializations are provided by the standard library

Defined in header <locale>
std::time_get_byname<char, InputIt> narrow/multibyte time parsing
std::time_get_byname<wchar_t, InputIt> wide string time parsing

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 extacts 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