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
  Le nombre de caractères à partir de strbuf.

• _Delim
  Le caractère qui doit se terminer lu s'il est produit avant _Count.

• _Str
  Une chaîne dans laquelle écrire.

Valeur de retour

Le flux de données (*this).

Notes

Le premier de ces retourne non formatés getline(_Str, _Count, widen("\n") de fonctions d'entrée).

La deuxième fonction récupère jusqu'à _Count - les éléments 1 et les stocke dans le début de tableau au _Str.Elle stocke toujours le caractère de fin de chaîne après que tous les éléments récupérés qu'il stocke.Dans l'ordre test, points d'extraction :

• À la fin du fichier.

• Une fois la fonction récupérer un élément qui compare une valeur égale à _Delimdans ce cas, l'élément n'est ni arrière mis ni ajouté à l'ordre d'exécution des instructions.

• Après la fonction récupère _Count - les éléments 1.

Si la fonction ne récupère pas d'élément 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>

l'espace de noms : DST

Voir aussi

Référence

basic_istream Class

programmation iostream

conventions d'iostreams