basic_istream::get
Lit un ou plusieurs caractères du flux d'entrée.
int_type get();
basic_istream<Elem, Tr>& get(
Elem& _Ch
);
basic_istream<Elem, Tr>& get(
Elem *_Str,
streamsize _Count
);
basic_istream<Elem, Tr>& get(
Elem *_Str,
streamsize _Count,
Elem _Delim
);
basic_istream<Elem, Tr>& get(
basic_streambuf<Elem, Tr>& _Strbuf
);
basic_istream<Elem, Tr>& get(
basic_streambuf<Elem, Tr>& _Strbuf,
Elem _Delim
);
Paramètres
_Count
Nombre de caractères à lire à partir de strbuf._Delim
Le caractère qui doit terminer la lecture s'il est rencontré avant _Count._Str
Une chaîne dans laquelle écrire._Ch
Un caractère à obtenir._Strbuf
Une mémoire tampon dans laquelle écrire.
Valeur de retour
Le formulaire sans paramètre de commande GET retourne l'élément affiché sous la forme d'un entier ou la fin du fichier. Les formulaires restants retournent le flux (*this).
Notes
La première de ces fonctions d'entrée non formatées extrait un élément, si possible, comme si elle retournait rdbuf->sbumpc. Sinon, elle retourne traits_type::EOF. Si la fonction n'extrait pas d'élément, elle appelle setstate(failbit).
La seconde fonction extrait l'élément int_type meta de la même manière. Si meta compare égale à traits_type::eof, la fonction appelle setstate(failbit). Sinon, il enregistre traits_type::to_char_type(meta) dans _Ch. La fonction retourne *this.
La troisième fonction retourne get(_Str, _Count, widen('\n')).
La quatrième fonction extrait jusqu'à _Count - 1 éléments et les stocke dans le tableau en commençant à _Str. Elle enregistre toujours char_type après n'importe quel élément qu'elle enregistre. Dans l'ordre de test, l'extraction s'arrête:
A la fin du fichier.
Après que la fonction extrait un élément qui se montre égal à _Delim, auquel cas l'élément est remis dans la séquence contrôlée.
Après que la fonction extrait _Count - 1 les éléments.
Si la fonction n'extrait pas d'élément, elle appelle setstate(failbit). Dans tous les cas, elle retourne *this.
La cinquième fonction retourne get(strbuf, widen('\n').
La sixième fonction extrait les éléments et les insère dans strbuf. L'extraction s'arrête à la fin du fichier ou sur un élément qui se montre égal à _Delim, qui n'est pas extrait. Elle cesse également, sans extraire l'élément en question, si une insertion échoue ou lève une exception (qui est interceptée mais non relancée). Si la fonction n'extrait pas d'élément, elle appelle setstate(failbit). Dans tous les cas, la fonction retourne *this.
Exemple
// basic_istream_get.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;
int main( )
{
char c[10];
c[0] = cin.get( );
cin.get( c[1] );
cin.get( &c[2],3 );
cin.get( &c[4], 4, '7' );
cout << c << endl;
}
Configuration requise
En-tête: <istream>
Espace de noms : std