std::time_get<CharT,InputIt>::get_year, std::time_get<CharT,InputIt>::do_get_year

来自cppreference.com
< cpp‎ | locale‎ | time get
 
C++
 
本地化库
 
std::time_get
 
在标头 <locale> 定义
public:

iter_type do_get_year( iter_type s, iter_type end, std::ios_base& str,

                       std::ios_base::iostate& err, std::tm* t ) const;
 (1)
protected:

virtual iter_type do_get_year( iter_type s, iter_type end, std::ios_base& str,

                               std::ios_base::iostate& err, std::tm* t ) const;
 (2)
1) 公开成员函数，调用最终派生类的受保护虚成员函数 do_get_year。
2) 读取来自序列 [beg, end) 的相继字符，用某个由实现定义的格式解析出年份。可能会因为本地环境接受两位的年份，由实现定义它们属于哪个世纪由实现定义。

将解析出的的年份存储到 std::tm 结构体域 t->tm_year。

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

参数

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

返回值

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

注解

对于两位输入值，许多实现会按与为 std::get_time、std::time_get::get() 和 POSIX 函数 strptime() 所用的转换指定符 '%y' 相同的规则进行解析：期待两位整数，范围 [69, 99] 中的值会产生值 1969 到 1999，范围 [00, 68] 会产生 2000-2068。四位输入典型地保持原状接受。

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

示例

运行此代码
#include <iostream>
#include <iterator>
#include <locale>
#include <sstream>
 
void try_get_year(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> const& facet = std::use_facet<std::time_get<char>>(str.getloc());
    std::istreambuf_iterator<char> ret = facet.get_year({str}, {}, str, err, &t);
    str.setstate(err);
    std::istreambuf_iterator<char> last{};
 
    if (str)
    {
        std::cout << "解析成功，年份是 " << 1900 + t.tm_year;
 
        if (ret != last)
        {
            std::cout << "，剩余内容：";
            std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
        }
        else
            std::cout << "，输入已全部消耗";
    }
    else
    {
        std::cout << "解析失败。尚未解析的字符串：";
        std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
    }
 
    std::cout << '\n';
}
 
int main()
{
    std::locale::global(std::locale("en_US.utf8"));
    try_get_year("13");
    try_get_year("2013");
 
    std::locale::global(std::locale("ja_JP.utf8"));
    try_get_year("2013年");
}

可能的输出： 

在本地环境 en_US.utf8 中从 '13' 解析年份
解析成功，年份是 2013，输入已全部消耗
在本地环境 en_US.utf8 中从 '2013' 解析年份
解析成功，年份是 2013，输入已全部消耗
在本地环境 ja_JP.utf8 中从 '2013年' 解析年份
解析成功，年份是 2013，剩余内容：年

缺陷报告

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

缺陷报告 应用于 出版时的行为 正确行为
LWG 248 C++98 在抵达尾迭代器时不会设置 eofbit 在没有读取到合法月名的情况下会设置 eofbit

参阅

(C++11)
 剖析指定格式的日期/时间值
(函数模板)
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/locale/time_get/get_year&oldid=86368”