std::time_get<CharT,InputIt>::get_monthname, std::time_get<CharT,InputIt>::do_get_monthname

来自cppreference.com
 
C++
 
文本处理库
 
本地化库
 
std::time_get
 
在标头 <locale> 定义 
public:
iter_type get_monthname( iter_type beg, iter_type end, std::ios_base& str,
                         std::ios_base::iostate& err, std::tm* t ) const;
(1) 
protected:
virtual iter_type do_get_monthname( iter_type beg, iter_type end, std::ios_base& str,
                                    std::ios_base::iostate& err, std::tm* t ) const;
(2)
1) 公开成员函数，调用最终派生类的受保护虚成员函数 do_get_monthname。
2) 从字符序列 [beg, end) 读取出相继字符，并按与为函数 std::get_time、time_get::get 和 POSIX 函数 strptime() 所用的此本地环境所期待的月名默认格式 "%b" 解析出月名（可能是缩写）。

如果它找到缩写名，那么它会持续读取，直到消耗尽完整名的字符，或找到不是期待的字符，后一情况下即使首段字符是合法缩写解析也会失败。

将解析出的的月名存储到 std::tm 域 t->tm_mon。

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

参数

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

返回值

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

注解

此函数通常不区别大小写。

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

示例

运行此代码
#include <ctime>
#include <iostream>
#include <iterator>
#include <locale>
#include <sstream>
#include <string_view>

void try_get_mon(std::string_view locale_name, std::string_view source)
{
    try
    {
        std::locale::global(std::locale(locale_name.data()));
    }
    catch (std::runtime_error const& ex)
    {
        std::cout << "无法设置本地环境: " << locale_name << "\n"
                     "异常: " << ex.what() << '\n';
        return;
    }

    std::cout << "在本地环境 " << std::locale().name()
              << " 中从 '" << s << "' 解析月名\n";
    std::istringstream str{source.data()};
    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_monthname({str}, {}, str, err, &t);
    str.setstate(err);
    std::istreambuf_iterator<char> last{};
 
    if (str)
    {
        std::cout << "解析成功，月份序数是 " << t.tm_wday;
 
        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()
{
    try_get_mon("ja_JP.utf8", "2月");
    try_get_mon("th_TH.utf8", "กุมภาพันธ์");
    try_get_mon("el_GR.utf8", "Φεβ");
    try_get_mon("el_GR.utf8", "Φεβρουάριος");
    try_get_mon("en_US.utf8", "Febrile");
}

输出： 

在本地环境 ja_JP.utf8 中从 '2月' 解析月名
解析成功，月份序数是 1，输入已全部消耗
在本地环境 th_TH.utf8 中从 'กุมภาพันธ์' 解析月名
解析成功，月份序数是 1，输入已全部消耗
在本地环境 el_GR.utf8 中从 'Φεβ' 解析月名
解析成功，月份序数是 1，输入已全部消耗
在本地环境 el_GR.utf8 中从 'Φεβρουάριος' 解析月名
解析成功，月份序数是 1，输入已全部消耗
在本地环境 en_US.utf8 中从 'Febrile' 解析月名
解析失败。尚未解析的字符串：ile

缺陷报告

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

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

参阅

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