Partager via


time_get::do_get_date

Une fonction membre virtuelle protégée qui est appelée pour analyser une chaîne comme date est produite par le spécificateur x pour strftime.

virtual iter_type do_get_date(
   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 de date 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 démarrage d'abord dans la séquence [_First, _Last) jusqu'à ce qu'elle soit identifié un champ d'entrée complet et non vide de date.En cas de réussite, il convertit ce champ à sa valeur équivalente comme composants tm::tm_mon, tm::tm_day, et tm::tm_year, et stocke les résultats dans le _pt->tm_mon, le _pt->tm_day et le _pt->tm_year, respectivement.Il retourne un itérateur qui indique le premier élément au delà de le champ d'entrée de date.Sinon, la fonction définit _Iosbase**::failbit** dans _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 de date.Dans les deux cas, si la valeur de retour égale _Last, la fonction définit ios_base::eofbit dans _State.

Le format du champ d'entrée de date est dépendant de paramètres régionaux.Pour les paramètres régionaux par défaut, le champ d'entrée de date a dd MMM de la forme, où AAAA :

  • MMM est mis en correspondance en appelant get_monthname, donnant le mois.

  • Dd est une séquence de chiffres décimaux dont la valeur numérique correspondante doit être comprise entre [1, 31], donnant le jour du mois.

  • AAAA est mis en correspondance en appelant get_year, donnant l'année.

Les espaces et les virgules de littéral doivent correspondre aux éléments correspondants dans la séquence d'entrée.

Exemple

Consultez l'exemple pour get_date, qui appelle do_get_date.

Configuration requise

en-tête : <locale>

l'espace de noms : DST

Voir aussi

Référence

time_get Class