std::time_get<CharT,InputIt>:: get_weekday, std::time_get<CharT,InputIt>:: do_get_weekday
|
定义于头文件
<locale>
|
||
|
public
:
iter_type get_weekday
(
iter_type beg, iter_type end,
std::
ios_base
&
str,
|
(1) | |
|
protected
:
virtual
iter_type do_get_weekday
(
iter_type beg, iter_type end,
std::
ios_base
&
str,
|
(2) | |
do_get_weekday
。
[
beg
,
end
)
中连续读取字符,并解析出星期名称(可能为缩写形式),使用该区域设置预期的默认星期格式,该格式与
"%a"
格式相同,被
std::get_time
、
time_get::get
函数以及 POSIX 函数
strptime()
所使用。
如果找到缩写名称,后跟适用于完整名称的有效字符,它会继续读取,直到消耗完完整名称的所有字符或找到不符合预期的字符,此时解析将失败,即使前几个字符是有效的缩写。
解析出的星期几存储在 std::tm 字段 t - > tm_wday 中。
如果在读取到有效星期名称之前到达结束迭代器,该函数将在 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 <initializer_list> #include <iostream> #include <iterator> #include <locale> #include <sstream> #include <string_view> void try_get_wday(std::string_view s) { std::cout << "正在从 '" << s << "' 中解析星期几,区域设置为 " << std::locale().name() << '\n'; std::istringstream str{s.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_weekday({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'; } void demo(std::string_view locale_name, std::initializer_list<std::string_view>&& data) { try { std::locale::global(std::locale(locale_name.data())); } catch (std::runtime_error const& ex) { std::cout << "无法设置区域设置: " << locale_name << "\n" "异常: " << ex.what() << '\n'; return; } for (std::string_view const weekday : data) try_get_wday(weekday); } int main() { demo("lt_LT.utf8", {"Št", "Šeštadienis"}); demo("en_US.utf8", {"SATELLITE"}); demo("ja_JP.utf8", {"土曜日"}); }
可能的输出:
正在从 'Št' 中解析星期几,区域设置为 lt_LT.utf8 解析成功,星期几编号为 6 输入已完全消耗 正在从 'Šeštadienis' 中解析星期几,区域设置为 lt_LT.utf8 解析成功,星期几编号为 6 输入已完全消耗 正在从 'SATELLITE' 中解析星期几,区域设置为 en_US.utf8 解析成功,星期几编号为 6 剩余内容: ELLITE 正在从 '土曜日' 中解析星期几,区域设置为 ja_JP.utf8 解析成功,星期几编号为 6 输入已完全消耗
缺陷报告
以下行为变更缺陷报告被追溯应用于先前发布的C++标准。
| 缺陷报告 | 应用于 | 发布时的行为 | 正确行为 |
|---|---|---|---|
| LWG 248 | C++98 |
到达结束迭代器时未设置
eofbit
|
若未读取到有效星期名称则设置
eofbit
|
参见
|
(C++11)
|
解析指定格式的日期/时间值
(函数模板) |