std::time_get<CharT,InputIt>:: get, std::time_get<CharT,InputIt>:: do_get

在循环体中，将执行以下步骤：

首先，通过执行 err = std:: ios_base :: goodbit 清除 err 中的错误位。随后从输入序列 [ beg, end ) 中读取符合 std::time_get 格式说明符预期的字符，该说明符由 '%' 、 modifier （若非 ' \0 ' ）和 format 组合而成。若字符未能构成有效的转换说明符，则在 err 中设置 failbit 。若读取字符后抵达输入流末端，则在 err 中设置 eofbit 。若输入字符串解析成功，则更新 * t 的对应字段。

对于复杂的转换说明符，例如 '%x' 或 '%c' ，以及使用修饰符 'E' 和 'O' 的指令，该函数可能无法确定要存储到 * t 中的某些值。在这种情况下，它会在 err 中设置 eofbit ，并将这些字段保留在未指定状态。

参数

格式字符串由零个或多个转换说明符、空白字符和普通字符（除 % 外）组成。每个普通字符需通过不区分大小写的比较与输入流中的一个字符匹配。每个空白字符可匹配输入字符串中的任意空白。每个转换规范以 % 字符开头，可选地后跟 E 或 O 修饰符（若区域设置不支持则忽略），最后是决定说明符行为的字符。格式说明符与 POSIX 函数 strptime() 的规范一致：

注意： tm_isdst 不会被自动写入，需要显式设置才能与 mktime 等函数配合使用

返回值

指向在 [ beg, end ) 范围内成功解析的最后一个字符之后位置的迭代器。

注释

对于格式字符串中非空白且非 '%' 字符的大小写不敏感比较，通常（但不一定）使用由 str 提供的locale的 std::collate facet。

如果遇到解析错误，此函数的许多实现会保持 * t 完全不变。

这些函数是否会对 * t 中未直接设置的字段进行清零操作是未指定的：可移植程序应在调用 get() 前将所有字段初始化为零。

示例

#include <iomanip>
#include <iostream>
#include <locale>
#include <sstream>
int main()
{
    std::istringstream ss("2026-März-12 23:45:56");
    ss.imbue(std::locale("de_DE.utf8"));
    auto& f = std::use_facet<std::time_get<char>>(ss.getloc());
    std::tm t{};
    std::string s = "%Y-%b-%d %H:%M:%S";
    std::ios_base::iostate err = std::ios_base::goodbit;
    auto ret = f.get({ss}, {}, ss, err, &t, &s[0], &s[0] + s.size());
    ss.setstate(err);
    std::istreambuf_iterator<char> last{};
    if (ss)
    {
        std::cout << "Successfully parsed as " << std::put_time(&t, "%c") << '\n';
        if (ret != last)
        {
            std::cout << "Remaining content: ";
            std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
        }
        else
            std::cout << "The input was fully consumed.";
    }
    else
    {
        std::cout << "Parse failed.\nUnparsed string: ";
        std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
    }
    std::cout << '\n';
}

Successfully parsed as Sun Mar 12 23:45:56 2026
The input was fully consumed.

参阅