Partager via


time_get::do_get_year

Une fonction membre virtuelle 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 adressage le début de la séquence à convertir.

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

  • _Iosbase
    Un indicateur de format qui lorsque la valeur indique que le symbole monétaire est facultatif ; sinon, il est requis.

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

  • _Pt
    Pointeur vers l'emplacement où les informations d'année doivent être stockées.

Valeur de retour

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

Notes

Tente protégés virtuels de fonctions membres pour correspondre aux éléments séquentiels commençant à _First dans la séquence [_First, _Last) jusqu'à ce qu'elle a identifié un champ d'entrée et vide fin d'année. Si a réussi, elle convertit ce champ dans sa valeur équivalente au tm::tm_yearcomposant, et stocke le résultat dans le _Pt->tm_year. Retourne un itérateur indiquant 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. Retourne un itérateur indiquant le premier élément au delà de tout préfixe d'un champ d'entrée valide d'année. Dans l'un et l'autre cas, si la valeur de retour est _Last, la fonction définit ios_base::eofbit dans le _State.

Le champ d'entrée year est une séquence de chiffres décimaux dont la valeur numérique correspondante doit figurer dans la plage de [1900, 2036). La valeur se trouve cette valeur moins 1900. Dans cette implémentation, les valeurs dans la plage de [69, 136) représente la plage d'années [1969, 2036). Valeurs dans la plage de [0, 69) sont également autorisés, mais peuvent représenter ou la plage d'années [1900, 1969) ou [2000, 2069), en fonction de l'environnement spécifique de traduction.

Exemple

Consultez l'exemple de get_year, qui appelle do_get_year.

Configuration requise

**En-tête :**paramètres régionaux <de >

Espace de noms : std

Voir aussi

Référence

time_get, classe