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 _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 un oggetto restituisce l'elemento visualizzato come Integer o di fine 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 viene estratto elemento, chiama setstate(failbit).
La seconda funzione estrae l'elemento metaint_type la stessa modalità.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 nell'inizio della matrice a _Str.Contiene sempre char_type dopo che tutti gli elementi che estrae i file.Per test, interruzioni di estrazione:
Alla fine di un file.
Dopo che la funzione viene disegnato un elemento che confronta uguale a _Delimin questo caso, l'elemento viene inserito nella sequenza selezionata.
Dopo la funzione estrae _Count - gli elementi 1.
Se la funzione non viene estratto 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 alla fine del file o su un elemento che confronta uguale a _Delim*,* che non è stato estratto.Si interrompe, senza estrarre l'elemento in questione, se un inserimento non riesce o genera un'eccezione (che viene intercettata ma non genera).Se la funzione non viene estratto 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
intestazione: <istream>
Spazio dei nomi: deviazione standard