basic_istream Class

Article
03/15/2013

Décrit un objet qui contrôle l'extraction des éléments et des objets codés à partir d'un mémoire tampon du flux avec des éléments de type Elem, également connu sous le nom char_type, dont traits de caractère sont déterminées par la classe Tr, également connu sous le nom traits_type.

template <class Elem, class Tr = char_traits<Elem> >
   class basic_istream
      : virtual public basic_ios<Elem, Tr>

Notes

La plupart du membre fonctionne cette surcharge opérateur >> sont mis en forme des fonctions d'entrée.Ils suivent le modèle :

    iostate state = goodbit;
    const sentry ok(*this);
    if (ok)
        {try
            {<extract elements and convert
            accumulate flags in state
            store a successful conversion> }
        catch (...)
            {try
                {setstate(badbit); }
            catch (...)
                {}
            if ((exceptions( ) & badbit) != 0)
                throw; }}
    setstate(state);
    return (*this);

De nombreuses autres fonctions membres sont des fonctions d'entrée non formatées.Ils suivent le modèle :

    iostate state = goodbit;
    count = 0;    // the value returned by gcount
    const sentry ok(*this, true);
    if (ok)
        {try
            {<extract elements and deliver
            count extracted elements in count
            accumulate flags in state> }
        catch (...)
            {try
                {setstate(badbit); }
            catch (...)
                {}
            if ((exceptions( ) & badbit) != 0)
                throw; }}
    setstate(state);

Les deux groupes d'appel de fonctions setstate(eofbit) si elles rencontrent la fin du fichier lors de l'extraction d'éléments.

An object of class basic_istream<Elem, Tr> banques :

Un objet de base virtuel publique de classe basic_ios<Elem, Tr>.
Un décompte d'extraction de la dernière opération d'entrée sans mise en forme (appelé count dans le code précédent).

Exemple

Consultez l'exemple de basic_ifstream Class pour en savoir plus sur les flux d'entrée.

Constructeurs

basic_istream

Construit un objet de type basic_istream.

Fonctions membres

gcount	Renvoie le nombre de caractères lus au cours de la dernière entrée non formatée.
Obtenir	Lit un ou plusieurs caractères dans le flux d'entrée.
getLine	Lit une ligne à partir du flux d'entrée.
ignore	Entraîne un nombre d'éléments à ignorer à partir de la position de lecture actuelle.
Peek	Retourne le prochain caractère à lire.
putback	Insère un caractère spécifié dans le flux.
read (lecture)	Lit un nombre spécifié de caractères à partir du flux et les stocke dans un tableau.
readsome	Lire à partir de la mémoire tampon uniquement.
seekg	Déplace la position de lecture dans un flux de données.
Sentry	La classe imbriquée décrit un objet dont la déclaration structures les fonctions d'entrée mise en forme et les fonctions d'entrée non formatées.
swap	Cet échange basic_istream objet proposées pour basic_istream paramètre d'objet.
Sync	Synchronise le périphérique d'entrée associé au flux avec une mémoire tampon du flux.
tellg	Signale la que position dans le flux de lecture en cours.
unget	Puts lire le dernier caractère dans le flux.

Opérateurs

opérateur >>	Appelle une fonction sur le flux d'entrée ou lit les données mises en forme à partir du flux d'entrée.
operator=	Attribue le basic_istream sur le côté droit de l'opérateur à cet objet.Il s'agit d'une affectation de déplacement impliquant une rvalue référence qui ne laisse pas une copie derrière.