std::time_get_byname

 

C++

Compiler support

Freestanding and hosted

Language

Standard library

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Metaprogramming library (C++11)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (C++17)

Regular expressions library (C++11)

Concurrency support library (C++11)

Execution support library (C++26)

Technical specifications

Symbols index

External libraries

 

Localization library

Locales and facets
Locales
has_facet use_facet	locale
Facet category base classes
ctype_base codecvt_base messages_base	time_base money_base
ctype facets
ctype ctype<char> ctype_byname	codecvt codecvt_byname
numeric facets
num_get num_put	numpunct numpunct_byname
collate facets
collate	collate_byname
time facets
time_get time_put	time_get_byname time_put_byname
monetary facets
money_get money_put	moneypunct moneypunct_byname
messages facets
messages	messages_byname

Character classification and conversion
Character classification
isspace isblank (C++11) iscntrl	isupper islower isalpha	ispunct isdigit isxdigit	isalnum isprint isgraph

Character conversions

toupper

tolower

String and stream conversions

wstring_convert (C++11/17/26*)

wbuffer_convert (C++11/17/26*)

Text encoding identifications

text_encoding (C++26)

Unicode conversion facets

codecvt_utf8 (C++11/17/26*)

codecvt_utf16 (C++11/17/26*)

codecvt_utf8_utf16 (C++11/17/26*)

codecvt_mode (C++11/17/26*)

C library locales
LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	setlocale localeconv lconv

 

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 = 0 );		(since C++11)

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 (C++11)	invokes do_get (public member function of std::time_get<CharT,InputIt>)

Protected member functions

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

See also

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