basic_istream::get
Legge uno o più caratteri dal flusso di input.
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
);
Parametri
_Count
Numero dei caratteri da leggere da strbuf._Delim
Il carattere che deve terminare lettura se viene rilevato prima di _Count._Str
Una stringa in cui scrivere._Ch
Un carattere da ottenere._Strbuf
Un buffer in cui scrivere.
Valore restituito
Il form senza parametri di ottiene a restituisce l'elemento visualizzato come integer o fine del file. I form rimanenti restituiscono il flussothis(*).
Note
Il primo di queste funzioni di input non formattato estrae un elemento, se possibile, ad esempio se restituisce rdbuf->sbumpc. In caso contrario, restituisce traits_type::EOF. Se la funzione non estrae elemento, viene chiamato setstate(failbit).
La seconda funzione estrae l'elemento meta di int_type lo stesso modo. Se meta si confronta uguale a traits_type::eof, le chiamate di funzione setstate(failbit). In caso contrario, archivia traits_type::to_char_type(meta) in _Ch. La funzione restituisce *this.
La terza funzione restituisce get(_Str, _Count, widen(') \n').
La quarta funzione estrae fino a _Count - elementi 1 e li archivia in inizio di matrice _Str. Contiene sempre char_type dopo qualsiasi elemento che estrae i file. Per test, interruzioni di estrazione:
Alla fine di un file.
Dopo che la funzione estrae un elemento in cui si confronta uguale a _Delimin questo caso, l'elemento viene inserito in sequenza selezionata.
Dopo function estrae _Count - gli elementi 1.
Se la funzione non consente di disegnare elementi, chiama setstate(failbit). Tuttavia, restituisce *this.
La quinta funzione restituisce get(strbuf, widen(') \n').
La sesta funzione estrae gli elementi e li inserisce in strbuf. Le estrazioni si arresta a scopo di file o su un elemento in cui si confronta uguale a _Delim*,* che non è stato estratto. Viene interrotto, senza estrarre l'elemento in questione, se un inserimento non riesce o genera un'eccezione (che viene intercettata ma non nuovo). Se la funzione non consente di disegnare elementi, chiama setstate(failbit). Tuttavia, la funzione restituisce *this.
Esempio
// 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;
}
Requisiti
istream <diIntestazione: >
Spazio dei nomi: std