std::time_get_byname

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

本地化库

区域设置和构面
区域设置
has_facet use_facet	locale
构面类别基类
ctype_base codecvt_base messages_base	time_base money_base
ctype 构面
ctype ctype<char> ctype_byname	codecvt codecvt_byname
数值构面
num_get num_put	numpunct numpunct_byname
整理构面
collate	collate_byname
时间构面
time_get time_put	time_get_byname time_put_byname
货币构面
money_get money_put	moneypunct moneypunct_byname
消息构面
messages	messages_byname

字符分类和转换
字符分类
isspace isblank (C++11) iscntrl	isupper islower isalpha	ispunct isdigit isxdigit	isalnum isprint isgraph

字符转换

toupper

tolower

字符串和流转换

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

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

文本编码标识

text_encoding (C++26)

Unicode 转换构面

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 库区域设置
LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	setlocale localeconv lconv

 

定义在头文件 <locale> 中
template<     class CharT,     class InputIt = std::istreambuf_iterator<CharT> > class time_get_byname : public std::time_get<CharT, InputIt>

std::time_get_byname 是一个 std::time_get 构面，它封装了在其构造时指定的区域设置的日期和时间解析规则。

特化

标准库保证提供满足以下类型要求的每个特化

• CharT 是 char 和 wchar_t 之一，并且
• InputIt 必须满足 LegacyInputIterator 的要求。

成员类型

成员类型	定义
char_type	CharT
iter_type	InputIt

成员函数

(构造函数)	构造一个新的 time_get_byname 构面 (公有成员函数)
(析构函数)	销毁一个 time_get_byname 构面 (受保护的成员函数)

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 );		(从 C++11 开始)

为具有 name 的区域设置构造一个新的 std::time_get_byname 构面。

refs 用于资源管理：如果 refs == 0，则当保存它的最后一个 std::locale 对象被销毁时，实现将销毁构面。否则，该对象不会被销毁。

参数

name	-	区域设置的名称
refs	-	链接到构面的引用数量

std::time_get_byname::~time_get_byname

protected: ~time_get_byname();

销毁构面。

从 std::time_get 继承而来

成员类型	定义
char_type	CharT
iter_type	InputIt

成员对象

成员名称	类型
id (静态)	std::locale::id

成员函数

date_order	调用 do_date_order (std::time_get<CharT,InputIt> 的公有成员函数)
get_time	调用 do_get_time (std::time_get<CharT,InputIt> 的公有成员函数)
get_date	调用 do_get_date (std::time_get<CharT,InputIt> 的公有成员函数)
get_weekday	调用 do_get_weekday (std::time_get<CharT,InputIt> 的公有成员函数)
get_monthname	调用 do_get_monthname (std::time_get<CharT,InputIt> 的公有成员函数)
get_year	调用 do_get_year (std::time_get<CharT,InputIt> 的公有成员函数)
get (C++11)	调用 do_get (std::time_get<CharT,InputIt> 的公有成员函数)

受保护的成员函数

do_date_order [虚拟]	获取星期、月份和年份的首选顺序 (std::time_get<CharT,InputIt> 的虚拟受保护成员函数)
do_get_time [虚拟]	从输入流中提取小时、分钟和秒 (std::time_get<CharT,InputIt> 的虚拟受保护成员函数)
do_get_date [虚拟]	从输入流中提取月份、日期和年份 (std::time_get<CharT,InputIt> 的虚拟保护成员函数)
do_get_weekday [虚拟]	从输入流中提取星期几的名称 (std::time_get<CharT,InputIt> 的虚拟保护成员函数)
do_get_monthname [虚拟]	从输入流中提取月份名称 (std::time_get<CharT,InputIt> 的虚拟保护成员函数)
do_get_year [虚拟]	从输入流中提取年份 (std::time_get<CharT,InputIt> 的虚拟保护成员函数)
do_get [virtual] (C++11)	根据指定的格式从输入流中提取日期/时间组件 (std::time_get<CharT,InputIt> 的虚拟保护成员函数)

继承自 std::time_base

类型	定义
dateorder	日期顺序枚举类型，定义了值 no_order、dmy、mdy、ymd 和 ydm

参见

time_get	将输入字符序列中的时间/日期值解析为 std::tm (类模板)
get_time (C++11)	解析指定格式的日期/时间值 (函数模板)