Partager via


time_get::do_get_date

Une fonction membre virtuelle est appelée pour analyser une chaîne comme date est générée par le spécificateur de 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 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 laquelle les informations de date 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 en premier dans la séquence [_First, _Last) jusqu'à ce qu'elle a identifié un champ d'entrée complet et de date vide. En cas de réussite, il convertit ce champ dans sa valeur équivalente en tant que composants tm::tm_mon, tm::tm_day, et tm::tm_year, puis enregistre les résultats dans le>_Pt-tm_mon, le>_Pt-tm_day et le>_Pt-tm_year, respectivement. Retourne un itérateur indiquant le premier élément au delà de le champ d'entrée de date. Sinon, la fonction définit _Iosbase**::failbit** dans _State. Retourne un itérateur indiquant le premier élément au delà de tout préfixe d'un champ d'entrée non valide de date. Dans l'un et l'autre cas, si la valeur de retour est _Last, la fonction définit ios_base::eofbit dans _State.

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

  • MMM correspond en appelant get_monthname, ce qui permet le mois.

  • DD comprend une séquence de chiffres décimaux dont la valeur numérique correspondante doit figurer dans la plage de [1, 31], ce qui permet le jour du mois.

  • AAAA est mis en correspondance en appelant get_year, ce qui permet l'année.

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

Exemple

Consultez l'exemple de get_date, qui appelle do_get_date.

Configuration requise

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

Espace de noms : std

Voir aussi

Référence

time_get, classe