Partager via


time_get::do_get_year

Une fonction membre virtuelle protégée qui est appelée analyse une chaîne comme nom de l'année.

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

Paramètres

  • _First
    Itérateur d'entrée adressant le début de la séquence à convertir.

  • _Last
    Itérateur d'entrée adressant la fin de la séquence à convertir.

  • _Iosbase
    Une balise de format qui lorsque la valeur indique que le symbole monétaire est facultatif ; sinon, si nécessaire.

  • _State
    Définit les éléments appropriés de masque de bits pour l'état de flux selon que les opérations ont réussi.

  • _Pt
    Un pointeur vers où les informations d'année doivent être stockées.

Valeur de retour

Un itérateur d'entrée adressant le premier élément au delà de le champ d'entrée.

Notes

Les tests protégés virtuels de fonction membre pour faire correspondre les éléments séquentiels en commençant à _First dans la séquence [_First, _Last) jusqu'à ce qu'elle soit identifié un champ d'entrée complet et non vide d'année.Si réussie, elle convertit ce champ à sa valeur équivalente comme tm::tm_yearcomposant, et stocke le résultat dans le _pt->tm_year.Elle retourne un itérateur qui indique le premier élément au delà de le champ d'entrée de l'année.Sinon, la fonction définit ios_base::failbit dans le _State.Elle retourne un itérateur qui indique le premier élément au delà de n'importe quel préfixe d'un champ d'entrée valide d'année.Dans les deux cas, si la valeur de retour égale _Last, la fonction définit ios_base::eofbit dans le _State.

Le champ d'entrée de l'année est une séquence de chiffres décimaux dont la valeur numérique correspondante doit être comprise entre [1900, 2036).La valeur signalée est la valeur moins 1900.Dans cette implémentation, valeurs dans la plage [69, 136) représente la plage des années [1969, 2036).Valeurs dans la plage [0, 69) et sont également autorisée, mais pouvez représenter ou la plage des années [1900, 1969) ou [2000, 2069), selon l'environnement spécifique de traduction.

Exemple

Consultez l'exemple pour get_year, qui appelle do_get_year.

Configuration requise

en-tête : <locale>

l'espace de noms : DST

Voir aussi

Référence

time_get Class