Partager via


getline

chaînes d'extrait de la ligne par ligne de flux d'entrée.

template<class CharType, class Traits, class Allocator>
   basic_istream<CharType, Traits>& getline(
      basic_istream<CharType, Traits>& _Istr,
      basic_string<CharType, Traits, Allocator>& _Str
   );
template<class CharType, class Traits, class Allocator>
   basic_istream< CharType, Traits >& getline(
       basic_istream< CharType, Traits >& _Istr,
       basic_string< CharType, Traits, Allocator >& _Str,
       CharType _Delim
   );
template<class Allocator, class Traits, class Allocator>
   basic_istream< Allocator, Traits >& getline(
        basic_istream< Allocator, Traits >&& _Istr,
        basic_string< Allocator, Traits, Allocator >& _Str
   );
template<class CharType, class Traits, class Allocator>
   basic_istream<CharType, Traits>& getline(
      basic_istream<CharType, Traits>&& _Istr,
      basic_string<CharType, Traits, Allocator>& _Str,
      const CharType _Delim
   );

Paramètres

  • _Istr
    Le flux d'entrée d'une chaîne doit être récupérée.

  • _Str
    La chaîne dans laquelle sont lus les caractères du flux d'entrée.

  • _Delim
    le séparateur de ligne.

Valeur de retour

La première fonction retourne getline( _Istr, _Str, _Istr.widen("\n")).

La deuxième fonction remplace la séquence contrôlée par _Str par une séquence d'éléments récupérés du flux de données _Istr.

Les fonctionnalités restantes sont les analogues précédemment à ceux, mais avec Lvalues et Rvalues.

Notes

Dans l'ordre de test, points d'extraction :

  • À la fin de le fichier.

  • Une fois que la fonction d'extraire un élément qui compare une valeur égale à delim, auquel cas l'élément n'est ni arrière mis ni ajouté à la séquence contrôlée.

  • Une fois que la fonction d'extraire des éléments d' str.max_size , auquel cas les appels de fonction setstate(ios_base::failbit).

Si la fonction n'extrait pas d'éléments, elle appelle setstate(failbit).Dans tous les cas, il retourne _Istr.

Exemple

Consultez string::getline pour un exemple d'utilisation getline.

Configuration requise

en-tête : <string>

l'espace de noms : type

Voir aussi

Référence

<string>

basic_string Class

string::getline

Autres ressources

<string> membres

membres basic_string