basic_istream Class

Articolo
03/15/2013

Descrive un oggetto che controlla l'estrazione di elementi e gli oggetti codificati da un buffer di flusso con elementi di tipo Elem, noto anche come char_type, con caratteristiche di carattere sono determinate dalla classe Tr, noto 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 del membro funzioni di overload operatore >> vengono formattate le funzioni di input.Essi 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 le funzioni di input non formattate.Essi 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 delle funzioni setstate(eofbit) se viene rilevata la fine del file durante l'estrazione di elementi.

An object of class basic_istream<Elem, Tr> archivi:

Un oggetto della classe base per il pubblico virtuale basic_ios<Elem, Tr>.
Un conteggio di estrazione per l'ultima operazione di input non formattato (chiamato conteggio nel codice precedente).

Esempio

Per vedere l'esempio basic_ifstream Class per ulteriori informazioni sui flussi di input.

Costruttori

basic_istream

Costruisce un oggetto di tipo basic_istream.

Funzioni 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	Fa sì che un numero di elementi da saltare l'attuale posizione di lettura.
Peek	Restituisce il carattere successivo da leggere.
putback	Inserisce un carattere specificato nel flusso.
read	Legge un numero specificato di caratteri dal flusso e li memorizza in una matrice.
readsome	Letti dal buffer solo.
seekg	Sposta la posizione di lettura in un flusso.
Sentry	La classe nidificata descrive un oggetto cui dichiarazione strutture le funzioni di input formattate e le funzioni di input non formattate.
scambio	Scambia questo basic_istream oggetto per il fornito basic_istream oggetto parametro.
sincronizzazione	Consente di sincronizzare il dispositivo di input associato al flusso con il buffer del flusso.
tellg	Indica la che posizione nel flusso di lettura corrente.
unget	PUT leggere l'ultimo carattere nel flusso.

Operatori

operatore >>	Chiama una funzione sul flusso di input o legge i dati formattati dal flusso di input.
operator=	Assegna il basic_istream sul lato destro dell'operatore per questo oggetto.Si tratta di un'assegnazione di spostamento che riguardano un rvalue riferimento non tralasciare una copia.