Partager via


time_get::get

Lit à partir d'une source de données de caractères et convertit ces données en un temps qui est stocké dans une structure de temps. La première fonction accepte un seul spécificateur et modificateur de conversion, la deuxième en accepte plusieurs.

iter_type get(
    iter_type _First, 
    iter_type _Last,
    ios_base& _Iosbase, 
    ios_base::iostate& _State, 
    tm *_Pt,
    char _Fmt, 
    char _Mod
) const;
iter_type get(
    iter_type _First, 
    iter_type _Last,
    ios_base& _Iosbase, 
    ios_base::iostate& _State, 
    tm *_Pt,
    char_type *_Fmt_first,  
    char_type *_Fmt_last
) const;

Paramètres

  • _First
    Itérateur d'entrée qui indique où la séquence à être convertie commence.

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

  • _Iosbase
    Flux.

  • _State
    Les éléments appropriés de masque de bits sont définis pour l'état du flux de données afin qu'ils indiquent les erreurs.

  • _Pt
    Pointeur vers la structure de temps où le temps doit être enregistré.

  • _Fmt
    Un caractère spécificateur de conversion.

  • _Mod
    Un caractère modificateur facultatif.

  • _Fmt_first
    Pointe là où les directives de format commencent.

  • _Fmt_last
    Pointe là où les directives de format finissent.

Valeur de retour

Retourne un itérateur vers le premier caractère après les données qui ont été utilisées pour affecter la structure de temps *_Pt.

Notes

La première fonction membre retourne do_get (_First, _Last, _Iosbase, _State, _Pt, _Fmt, _Mod).

La deuxième fonction membre appelle do_get sous le contrôle du format délimité par [_Fmt_first,_Fmt_last). Il traite le format sous la forme d'une séquence de champs, dont chacun détermine la conversion de zéro ou plus d'éléments d'entrée délimités par [first, last). Retourne un itérateur indiquant le premier élément non converti. Il existe trois types de champs :

Un pourcentage (%) dans le format, suivi d'un modificateur mod facultatif dans la série [EOQ#], et suivi d'un spécifieur de conversion fmt, remplace first par la valeur retournée par do_get (_First, _Last, _Iosbase, _State, _Pt, _Fmt, _Mod). Une erreur de conversion inscrit ios_base::failbit dans state et procède au return.

Un élément whitespace dans le format ignore le zéro passé ou plusieurs éléments whitespace d'entrée.

Tout autre élément de ce format doit correspondre à l'élément d'entrée suivant, qui est ignoré. Une erreur de conversion inscrit ios_base::failbit dans state et procède au return.

Configuration requise

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

Espace de noms : std

Voir aussi

Référence

time_get::do_get

time_get, classe

<locale>

Autres ressources

membres de time_get

<locale> membres