basic_istream::getline
Obtient une ligne du flux d'entrée.
basic_istream<Elem, Tr>& getline(
char_type *_Str,
streamsize _Count
);
basic_istream<Elem, Tr>& getline(
char_type *_Str,
streamsize _Count,
char_type _Delim
);
Paramètres
_Count
Nombre de caractères à lire depuis strbuf._Delim
Le caractère qui doit terminer la lecture si elle est rencontrée avant _Count._Str
Chaîne dans laquelle écrire.
Valeur de retour
Le flux de données (*this).
Notes
Le premier de ces retourne pas formatés getline(_Str, _Count, widen("\n") de fonctions d'entrée).
La deuxième fonction extrait jusqu'à _Count - les éléments 1 et les stocke dans le début de table au _Str. Enregistre toujours le caractère de fin de chaîne après que tous les éléments extraits il stocke. Par ordre de test, laquelle l'extraction :
À la fin de fichier.
Après la fonction extraie un élément qui compare égale à _Delim, auquel cas l'élément n'est ni restaurée ni mise ajouté à la séquence contrôlée.
Après la fonction extrait _Count - les éléments 1.
Si la fonction n'extrait pas d'éléments ou _Count - 1 les éléments, elle appelle setstate(failbit). Dans tous les cas, elle retourne *this.
Exemple
// basic_istream_getline.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;
int main( )
{
char c[10];
cin.getline( &c[0], 5, '2' );
cout << c << endl;
}
Configuration requise
**En-tête :**istream <de >
Espace de noms : std