operator>> (<istream>)

Récupère les caractères et les chaînes du flux.

template<class Elem, class Tr>
    basic_istream<Elem, Tr>& operator>>(
        basic_istream<Elem, Tr>& _Istr, 
        Elem *_Str
    );
template<class Elem, class Tr>
    basic_istream<Elem, Tr>& operator>>(
        basic_istream<Elem, Tr>& _Istr, 
        Elem& _Ch
    );
template<class Tr>
    basic_istream<char, Tr>& operator>>(
        basic_istream<char, Tr>& _Istr, 
        signed char *_Str
    );
template<class Tr>
    basic_istream<char, Tr>& operator>>(
        basic_istream<char, Tr>& _Istr, 
        signed char& _Ch
    );
template<class Tr>
    basic_istream<char, Tr>& operator>>(
        basic_istream<char, Tr>& _Istr, 
        unsigned char *_Str
    );
template<class Tr>
    basic_istream<char, Tr>& operator>>(
        basic_istream<char, Tr>& _Istr, 
        unsigned char& _Ch
    );
template<class Elem, class Tr, class Type>
    basic_istream<Elem, Tr>& operator>>(
        basic_istream<char, Tr>&& _Istr,
        Type& _Val
    );

Paramètres

• _Ch
  Caractère.

• _Istr
  Un flux

• _Str
  une chaîne ;

• _Val
  Un type.

Valeur de retour

Le flux

Notes

La classe d' basic_istream définit également plusieurs opérateurs d'extraction.Pour plus d'informations, consultez basic_istream::operator>>.

La fonction de modèle :

template<class Elem, class Tr>
   basic_istream<Elem, Tr>& operator>>(
      basic_istream<Elem, Tr>& _Istr, Elem *_Str);

les extraits jusqu' à N - les éléments 1 et les stocke dans le tableau de départ au _Str.Si _Istr.largeur supérieur à zéro, N est _Istr.largeur; sinon, il s'agit de la taille de la plus grand tableau d' Elem qui peut être déclarée.La fonction stocke toujours la valeur Elem() après que tous les éléments récupérés qu'elle enregistre.L'extraction arrête dès l'abord de fin de fichier, d'un caractère avec la valeur Elem(0) (qui n'est pas récupérée), ou sur tout élément (qui n'est pas extrait) qui serait ignoré par le WS.Si la fonction ne récupère pas d'éléments, elle appelle _Istr.setstate(failbit).Dans tous les cas, elle appelle _Istr.largeur(0) et retourne _Istr.

Security Note la chaîne terminée par le caractère NULL qui est extraite du flux d'entrée ne doit pas dépasser la taille de la mémoire tampon _Strde destination.Pour plus d'informations, consultez Solutions contre les dépassements de mémoire tampon.

La fonction de modèle :

template<class Elem, class Tr>
   basic_istream<Elem, Tr>& operator>>(
      basic_istream<Elem, Tr>& _Istr, Elem& _Ch);

extrait un élément, si possible, et le stocke dans _Ch.Sinon, il appelle is.setstate(failbit).Dans tous les cas, il retourne _Istr.

La fonction de modèle :

template<class Tr>
   basic_istream<char, Tr>& operator>>(
      basic_istream<char, Tr>& _Istr, signed char *_Str);

retourne _Istr >> (char*****)_Str.

La fonction de modèle :

template<class Tr>
   basic_istream<char, Tr>& operator>>(
      basic_istream<char, Tr>& _Istr, signed char& _Ch);

retourne _Istr >> (char&)_Ch.

La fonction de modèle :

template<class Tr>
   basic_istream<char, Tr>& operator>>(
      basic_istream<char, Tr>& _Istr, unsigned char *_Str);

retourne _Istr >> (char *)_Str.

La fonction de modèle :

template<class Tr>
   basic_istream<char, Tr>& operator>>(
      basic_istream<char, Tr>& _Istr, unsigned char& _Ch);

retourne _Istr >> (char&)_Ch.

La fonction de modèle :

template<class Elem, class Tr, class Type>
   basic_istream<Elem, Tr>& operator>>(
      basic_istream<char, Tr>&& _Istr,
      Type& _Val
   );

retourne _Istr>>_Val (et convertis rvalue reference à _Istr à lvalue dans le processus).

Exemple

// istream_op_extract.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;

int main( ) 
{
   ws( cin );
   char c[10];

   cin.width( 9 );
   cin >> c;
   cout << c << endl;
}

Entrée

1234567890

Sortie

12345678

Configuration requise

en-tête : <istream>

l'espace de noms : DST

Voir aussi

Référence

basic_istream::operator>>

programmation iostream

conventions d'iostreams