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

En el cuerpo del bucle, se llevan a cabo los siguientes pasos:

Primero, limpia los bits de error en err ejecutando err = std:: ios_base :: goodbit . Luego lee caracteres de la secuencia de entrada [ beg, end ) que son esperados por el especificador de formato std::time_get formado al combinar '%' , modifier (si no es ' \0 ' ), y format . Si los caracteres no se combinan para formar un especificador de conversión válido, establece failbit en err . Si se alcanza el final del flujo de entrada después de leer un carácter, establece eofbit en err . Si la cadena de entrada fue analizada exitosamente, actualiza los campos correspondientes de * t .

Para especificadores de conversión complejos, como '%x' o '%c' , o las directivas que utilizan los modificadores 'E' y 'O' , la función puede fallar al determinar algunos de los valores a almacenar en * t . En tal caso, establece eofbit en err y deja estos campos en estado no especificado.

Parámetros

La cadena de formato consiste en cero o más especificadores de conversión, caracteres de espacio en blanco y caracteres ordinarios (excepto % ). Se espera que cada carácter ordinario coincida con un carácter en el flujo de entrada en comparación sin distinción entre mayúsculas y minúsculas. Cada carácter de espacio en blanco coincide con espacios en blanco arbitrarios en la cadena de entrada. Cada especificación de conversión comienza con el carácter % , opcionalmente seguido por el modificador E o O (ignorado si no es compatible con la configuración regional), seguido del carácter que determina el comportamiento del especificador. Los especificadores de formato coinciden con la función POSIX strptime() :

Nota: tm_isdst no se escribe, y debe establecerse explícitamente para su uso con funciones como mktime

Valor de retorno

Iterador que apunta una posición después del último carácter en [ beg, end ) que fue analizado exitosamente.

Notas

La comparación que no distingue entre mayúsculas y minúsculas para los caracteres que no son espacios en blanco ni '%' en la cadena de formato, normalmente, pero no necesariamente, se utiliza el facet std::collate de la configuración regional proporcionada por str .

Si se encuentra un error de análisis, muchas implementaciones de esta función dejan * t completamente intacto.

No está especificado si estas funciones ponen a cero los campos en * t que no establecen directamente: los programas portables deben inicializar cada campo a cero antes de llamar a get() .

Ejemplo

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

Véase también