Classe basic_istream

Articolo
06/09/2015

Viene descritto un oggetto che l'estrazione dei controlli degli elementi e degli oggetti codificati da un buffer del flusso con elementi di tipo Elem, noti anche come char_type, in cui i tratti di carattere sono determinati dalla classe TR, nota anche come traits_type.

template <class Elem, class Tr = char_traits<Elem> > 
   class basic_istream 
      : virtual public basic_ios<Elem, Tr>

Note

La maggior parte delle funzioni membro in overload operatore>> sono funzioni di input formattate. Seguono il modello:

    iostate state = goodbit;
    const sentry ok(*this);
    if (ok)
        {try
            {<extract elements and convert
            accumulate flags in state
            store a successful conversion> }
        catch (...)
            {try
                {setstate(badbit); }
            catch (...)
                {}
            if ((exceptions( ) & badbit) != 0)
                throw; }}
    setstate(state);
    return (*this);

Molte altre funzioni membro sono funzioni di input non formattato. Seguono il modello:

    iostate state = goodbit;
    count = 0;    // the value returned by gcount
    const sentry ok(*this, true);
    if (ok)
        {try
            {<extract elements and deliver
            count extracted elements in count
            accumulate flags in state> }
        catch (...)
            {try
                {setstate(badbit); }
            catch (...)
                {}
            if ((exceptions( ) & badbit) != 0)
                throw; }}
    setstate(state);

Entrambi i gruppi di chiamata di funzioni setstate(eofbit) se rilevano fine del file durante l'estrazione degli elementi.

Un oggetto di classe basic_istream<Elem, TR> file:

Un oggetto virtuale di base pubblici di classe basic_ios<Elem, TR>.
Un conteggio di estrazione per l'ultima operazione di input non formattato (chiamata count nel codice precedente).

Esempio

Vedere l'esempio relativo Classe basic_ifstream per ulteriori informazioni sui flussi di input.

Costruttori

basic_istream

Crea un oggetto di tipo basic_istream.

Funzioni del membro

gcount	Restituisce il numero di caratteri letti durante l'ultimo input non formattato.
get	Legge uno o più caratteri dal flusso di input.
getline	Legge una riga dal flusso di input.
ignore	Indurre una serie di elementi di ignorare dalla posizione corrente lettura.
sbirciata	Restituisce il carattere successivo da leggere.
putback	Inserisce un carattere specificato nel flusso.
read	Legge un numero specificato di caratteri dal flusso e li archivia in una matrice.
readsome	Letto da solo buffer.
seekg	Spostare la posizione lettura a un flusso.
sentinella	La classe annidata viene descritto un oggetto di cui la dichiarazione struttura le funzioni di input formattate e le funzioni di input non formattato.
scambio	Scambia questo oggetto di basic_istream per il parametro specificato dell'oggetto di basic_istream.
sincronizzazione	Sincronizza il dispositivo di input associato al flusso con il buffer del flusso.
tellg	Indica la posizione corrente del flusso.
unget	Inserire il carattere più recentemente lettura nel flusso.

Operatori

l'operatore ':?'>>	Chiama una funzione sul flusso di input oppure legge i dati formattati dal flusso di input.
operator=	Assegna basic_istream sul lato destro dell'operatore su questo oggetto. Si tratta di assegnazione di spostamento che include un riferimento a rvalue che non consente una copia behind.