basic_istream, classe

Article
06/09/2015

Décrit un objet qui contrôle l'extraction des éléments et des objets encodés d'une mémoire tampon du flux avec les éléments de type Elem, également appelé char_type, dont les caractéristiques de caractères sont déterminées par la classe TR, également appelé traits_type.

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

Notes

La plupart des fonctions membres qui sont opérateur>> surchargent les fonctions d'entrée mises en forme. 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 mises en forme. 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) s'ils rencontrent fin de fichier lors de l'extraction des éléments.

Un objet de la classe basic_istream<Elem, TR> journaux :

Objet de base public virtuel de la classe basic_ios<Elem, TR>.
Nombre d'extraction de la dernière opération d'entrée non formatée ( count appelé dans le code précédent).

Exemple

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

Constructeurs

basic_istream

Construit un objet de type basic_istream.

Fonctions membres

gcount	Retourne le nombre de caractères lus lors de la dernière entrée non formatée.
Obtenir	Lit un ou plusieurs caractères du flux d'entrée.
getline	Lit une ligne du flux d'entrée.
ignore	Entraîne plusieurs éléments à ignorer de la position de lecture actuelle.
coup d'œil	Retourne le caractère suivant à lire.
putback	Empile un caractère spécifié dans le flux de données.
read (lecture)	Lit un nombre spécifié de caractères du flux de données et les stocke dans un tableau.
readsome	Lecture de mémoire tampon uniquement.
seekg	Déplace la position de lecture dans un flux de données.
sentinelle	La classe imbriquée décrit un objet dont la déclaration structure des fonctions d'entrée mises en forme et les fonctions d'entrée non mises en forme.
échange	Échange cet objet d'basic_istream pour le paramètre spécifié de l'objet d'basic_istream.
synchronisation	Synchronise l'unité d'entrée associé au flux de données avec la mémoire tampon du flux de données.
tellg	Indique la position de lecture actuelle dans le flux de données.
unget	Met en dernier caractère de lecture de nouveau au flux de données.

Opérateurs

.>>	Appelle une fonction dans le flux d'entrée lit les données mises en forme du flux d'entrée.
operator=	Affecte basic_istream à droite de l'opérateur à cet objet. Il s'agit d'une assignation de déplacement impliquant une référence d'rvalue qui ne permet pas de copie de.