Compartir a través de


time_get::do_get_year

Una función virtual protegida de miembro que se llama a analiza una cadena como nombre del año.

virtual iter_type do_get_year( 
   iter_type _First,  
   iter_type _Last, 
   ios_base& _Iosbase,  
   ios_base::iostate& _State,  
   tm* _Pt 
) const;

Parámetros

  • _First
    Entre el iterador que indica al principio de la secuencia que se va a convertir.

  • _Last
    Entre el iterador que indica al final de la secuencia que se va a convertir.

  • _Iosbase
    Un indicador de formato que cuando el conjunto indica que el símbolo de moneda es opcional; si no, se requiere.

  • _State
    Establece los elementos adecuados de la máscara de bits para el estado de la secuencia según si las operaciones se completan correctamente.

  • _Pt
    Un puntero a donde va a almacenar la información del año.

Valor devuelto

Un iterador de entrada que dirige el primer elemento más allá del campo de entrada.

Comentarios

La función protegida miembro virtual intenta hacer coincidir los elementos secuenciales que comienzan en _First en la secuencia [_First, _Last) hasta que haya reconocido un campo de entrada completo, no vacío del año. Si es correcta, convierte este campo a su valor equivalente como tm::tm_yearcomponente, y almacena el resultado en el _Pt->tm_year. Devuelve un iterador que designa el primer elemento más allá del campo de entrada del año. Si no, la función establece ios_base::failbit en _State. Devuelve un iterador que designa el primer elemento más allá de cualquier prefijo de un campo de entrada válido del año. En cualquier caso, si el valor devuelto es igual a _Last, la función establece ios_base::eofbit en _State.

El campo de entrada del año es una secuencia de dígitos decimales cuyo valor numérico correspondiente debe estar en el intervalo [1900, 2036). El valor almacenado es este valor menos 1900. En esta implementación, valores del intervalo [69, 136) representa el radio de acción de años [1969, 2036). Valores del intervalo [0, 69) también es válido, pero puede representar o el radio de acción de años [1900, 1969) o [2000, 2069), según el entorno específico de traducción.

Ejemplo

Vea el ejemplo para get_year, que llama a do_get_year.

Requisitos

configuración regional <deEncabezado: >

Espacio de nombres: std

Vea también

Referencia

time_get (Clase)