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

루프 본문에서 다음과 같은 단계가 수행됩니다:

먼저, err 의 오류 비트들을 err = std:: ios_base :: goodbit 을 실행하여 초기화합니다. 그런 다음 입력 시퀀스 [ beg, end ) 에서 std::time_get 형식 지정자에 의해 예상되는 문자들을 읽습니다. 이 형식 지정자는 '%' , modifier ( ' \0 ' 이 아닌 경우), 그리고 format 을 조합하여 형성됩니다. 만약 문자가 유효한 변환 지정자를 형성하지 않으면, err 에 failbit 를 설정합니다. 문자를 읽은 후 입력 스트림의 끝에 도달하면, err 에 eofbit 를 설정합니다. 입력 문자열이 성공적으로 파싱되면, * t 의 해당 필드들을 업데이트합니다.

복잡한 변환 지정자, 예를 들어 '%x' 또는 '%c' , 또는 수정자 'E' 와 'O' 를 사용하는 지시자의 경우, 함수가 * t 에 저장할 일부 값을 결정하지 못할 수 있습니다. 이러한 경우에는 err 에서 eofbit 을 설정하고 이러한 필드들을 지정되지 않은 상태로 남겨둡니다.

매개변수

형식 문자열은 0개 이상의 변환 지정자, 공백 문자, 그리고 일반 문자( % 제외)로 구성됩니다. 각 일반 문자는 대소문자를 구분하지 않는 비교에서 입력 스트림의 한 문자와 일치할 것으로 예상됩니다. 각 공백 문자는 입력 문자열의 임의의 공백과 일치합니다. 각 변환 지정은 % 문자로 시작하며, 선택적으로 E 또는 O 수식어(로캘에서 지원되지 않으면 무시됨)가 뒤따르고, 해당 지정자의 동작을 결정하는 문자로 끝납니다. 형식 지정자는 POSIX 함수 strptime() 와 일치합니다:

참고: tm_isdst 는 기록되지 않으며, mktime 와 같은 함수와 함께 사용하려면 명시적으로 설정해야 합니다.

반환값

성공적으로 파싱된 [ beg, end ) 범위에서 마지막 문자 바로 다음을 가리키는 반복자.

참고 사항

형식 문자열에서 공백이 아닌 비- '%' 문자들에 대한 대소문자 구분 없는 비교는 일반적으로 str 이 제공하는 로캘의 std::collate 패싯을 사용하지만, 반드시 그런 것은 아닙니다.

파싱 오류가 발생하면, 이 함수의 많은 구현에서 * t 를 완전히 변경하지 않고 그대로 둡니다.

이러한 함수들이 직접 설정하지 않는 * t 의 필드들을 제로 아웃하는지 여부는 명시되지 않았습니다: 이식 가능한 프로그램들은 get() 을 호출하기 전에 모든 필드를 0으로 초기화해야 합니다.

예제

#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.

참고 항목