std::time_get<CharT,InputIt>::get_time, std::time_get<CharT,InputIt>::do_get_time

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

技术规范

符号索引

外部库

 

本地化库

本地环境与平面
本地环境
locale
use_facet	has_facet
平面类别基类
ctype_base codecvt_base messages_base	time_base money_base
ctype（字符类别）平面
ctype ctype_byname ctype<char>	codecvt codecvt_byname
numeric（数值）平面
num_get num_put	numpunct numpunct_byname
collate（对照比较）平面
collate	collate_byname
time（时间）平面
time_get time_get_byname	time_put time_put_byname
monetary（货币）平面
money_get money_put	moneypunct moneypunct_byname
messages（消息）平面
messages	messages_byname
字符分类与转换
字符分类
isspace isblank (C++11) iscntrl isupper islower isalpha	isdigit ispunct isxdigit isalnum isprint isgraph
转换
toupper tolower	wstring_convert (C++11) wbuffer_convert (C++11)
编码转换平面
codecvt_utf8 (C++11) codecvt_utf16 (C++11)	codecvt_utf8_utf16 (C++11) codecvt_mode (C++11)
C 本地环境
LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	setlocale localeconv lconv

 

std::time_get

成员函数

time_get::time_get

time_get::~time_get

time_get::date_ordertime_get::do_date_order

time_get::get_timetime_get::do_get_time

time_get::get_datetime_get::do_get_date

time_get::get_weekdaytime_get::do_get_weekday

time_get::get_monthnametime_get::do_get_monthname

time_get::get_yeartime_get::do_get_year

time_get::gettime_get::do_get

 

在标头 <locale> 定义
public: iter_type get_time( iter_type beg, iter_type end, std::ios_base& str,                     std::ios_base::iostate& err, std::tm* t ) const;	(1)
protected: virtual iter_type get_time( iter_type beg, iter_type end, std::ios_base& str,                             std::ios_base::iostate& err, std::tm* t ) const;	(2)

1) 公开成员函数，调用最终派生类的受保护虚成员函数 do_get_time。

2) 从字符序列 [beg, end) 读取相继的字符，并按与为函数 std::get_time、time_get::get 和 POSIX 函数 strptime() 所用的格式指定符 "%H:%M:%S" 相同的规则解析时间值。

将解析出的时间存储到到参数 t 指向的 std::tm 结构体的对应域中。

如果在读到合法时间前抵达尾迭代器，那么函数会设置 err 中的 std::ios_base::eofbit。如果遇到解析错误，那么函数会设置 err 中的 std::ios_base::failbit。

参数

beg	-	指代要解析的序列起始的迭代器
end	-	要解析的序列的尾后一位置迭代器
str	-	此函数在需要时用以获得本地环境平面的流对象，例如用 std::ctype 跳过空白符
err	-	此函数所修改以指示错误的流错误标志对象
t	-	指向 std::tm 对象的指针，该对象将保有此函数调用结果

返回值

指向 [beg, end) 中辨识为合法日期一部分的末字符后一位置的迭代器。

注意

对于默认时间格式的字母组分（如果存在），此函数通常不区别大小写。

如果遇到解析错误，那么此函数的大多数实现保留 *t 不修改。

示例

运行此代码

#include <iostream>
#include <locale>
#include <sstream>
#include <iterator>
 
void try_get_time(const std::string& s)
{
    std::cout << "在本地环境 " << std::locale().name()
              << " 中从 '" << s << "' 解析时间\n";
    std::istringstream str(s);
    std::ios_base::iostate err = std::ios_base::goodbit;
 
    std::tm t;
    std::time_get<char> facet = std::use_facet<std::time_get<char>>(str.getloc())
    std::istreambuf_iterator<char> ret = facet.get_time({str}, {}, str, err, &t);
    str.setstate(err);
 
    if (str)
    {
        std::cout << "时：" << t.tm_hour << ' '
                  << "分：" << t.tm_min  << ' '
                  << "秒：" << t.tm_sec  << '\n';
    }
    else
    {
        std::cout << "解析失败。尚未解析的字符串：";
        std::copy(ret, {}, std::ostreambuf_iterator<char>(std::cout));
        std::cout << '\n';
    }
}
 
int main()
{
    std::locale::global(std::locale("ru_RU.utf8"));
    try_get_time("21:40:11");
    try_get_time("21-40-11");
 
    std::locale::global(std::locale("ja_JP.utf8"));
    try_get_time("21時37分58秒");
}

输出：

在本地环境 ru_RU.utf8 中从 '21:40:11' 解析时间
时：21 分：40 秒：11
在本地环境 ru_RU.utf8 中从 '21-40-11' 解析时间
解析失败。尚未解析的字符串：-40-11
在本地环境 ja_JP.utf8 中从 '21時37分58秒' 解析时间
时：21 分：37 秒：58

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
LWG 248	C++98	在抵达尾迭代器时不会设置 eofbit	在没有读取到合法时间的情况下会设置 eofbit
LWG 461	C++98	do_get_time 需要解析本地化的时间表示	以 "%H:%M:%S" 格式解析

参阅

get_time (C++11)

剖析指定格式的日期/时间值 (函数模板)