basic_istream Class

Artigo
03/14/2013

Descreve um objeto que controla a extração de elementos e objetos codificados em um buffer de fluxo com elementos do tipo Elem, também conhecido como char_type, cujas características de caractere são determinadas pela classe Tr, também conhecido como traits_type.

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

Comentários

A maioria do membro funções que sobrecarga operador >> formatados funções de entrada.Eles seguem o padrão:

    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);

Muitas outras funções de membro são funções não formatadas de entrada.Eles seguem o padrão:

    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);

Ambos os grupos de funções chamada setstate(eofbit) se eles encontrarem o final do arquivo enquanto estiver extraindo elementos.

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

Um objeto de base público virtual de classe basic_ios<Elem, Tr>.
Uma contagem de extração para a última operação de entrada não formatada (chamado count no código anterior).

Exemplo

Consulte o exemplo para basic_ifstream Class para saber mais sobre os fluxos de entrada.

Construtores

basic_istream

Constrói um objeto do tipo basic_istream.

Funções de membro

gcount	Retorna o número de caracteres lidos durante a última entrada sem formatação.
obter	Lê um ou mais caracteres do fluxo de entrada.
getline	Lê uma linha do fluxo de entrada.
Ignorar	Faz com que um número de elementos ignorada na atual posição de leitura.
Peek	Retorna o próximo caractere a ser lido.
putback	Coloca um caractere especificado no fluxo.
ler	Lê um número especificado de caracteres do fluxo e armazena em uma matriz.
readsome	Ler somente buffer.
seekg	Move a posição de leitura em um fluxo.
Sentinela	A classe aninhada descreve um objeto cuja declaração de estruturas de funções de entrada formatadas e as funções de entrada não formatadas.
troca	Troca isso basic_istream objeto fornecida basic_istream parâmetro de objeto.
sincronização	Sincroniza o dispositivo associado com o fluxo de buffer do fluxo de entrada.
tellg	Relatórios de que posição no fluxo de leitura atual.
unget	Coloca mais recentemente ler caractere de volta no fluxo.

Operadores

operador >>	Chama uma função no fluxo de entrada ou lê dados formatados do fluxo de entrada.
operador =	Atribui o basic_istream no lado direito do operador para este objeto.Esta é uma atribuição de mover envolvendo um rvalue referência não deixar uma cópia.