Partager via


operator>> (<string>)

Une fonction de modèle qui lit une chaîne d'un flux d'entrée.

template<class CharType, class Traits, class Allocator>
   basic_istream<CharType, Traits>& operator>>(
      basic_istream<CharType, Traits>& _Istr,
      basic_string<CharType, Traits, Allocator>& _Right
   );

Paramètres

  • _Istr
    Le flux d'entrée utilisé pour extraire la séquence

  • _Right
    La chaîne extraite du flux d'entrée.

Valeur de retour

Lit la valeur de la chaîne spécifiée depuis _Istr et la retourne dans _Right.

Notes

L'opérateur ignore les espaces blancs à moins que l'indicateur skipws soit défini. Il lit tous les caractères suivants jusqu'à ce que le caractère suivant soit un espace ou que la fin du fichier soit atteinte.

La fonction de modèle surcharge opérateur>> pour remplacer la séquence contrôlée par _Right par une séquence d'éléments extraits du flux de données _Istr. L'extraction s'arrête :

  • A la fin du fichier.

  • Après que la fonction a extrait les éléments _Istr.width, si cette valeur est différente de zéro.

Après que la fonction a extrait les éléments _Istr.max_size.

  • Après que la fonction a extrait un élément ch pour lequel use_facet<ctype<CharType> >( getloc). is( ctype<CharType>::space, ch) est true, auquel cas le caractère a été remis.

Si la fonction n'extrait pas d'élément, elle appelle setstate(ios_base::failbit) Dans tous les cas, il appelle istr.width(0) et retourne *this.

Exemple

// string_op_read_.cpp
// compile with: /EHsc
#include <string>
#include <iostream>

int main( )
{
   using namespace std;

   string c0;
   cout << "Input a string c0 ( try: Fibonacci numbers ): ";
   cin >> c0;
   cout << "The string entered is c0 = " << c0 << endl;
}

Entrée

Fibonacci numbers

Résultat de l'exemple

Input a string c0 ( try: Fibonacci numbers ): Fibonacci numbers
The string entered is c0 = Fibonacci

Configuration requise

En-tête : <chaîne>

Espace de noms : std

Voir aussi

Référence

string::operator>>