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