Classe basic_istream

Artigo
06/09/2015

Descreve um objeto que extração dos controles dos elementos e de objetos codificados de um buffer de fluxo com os elementos de tipo Elem, também conhecidos como char_type, cujos características de caractere são determinados pela classe Tr, também conhecida como traits_type.

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

Comentários

A maioria das funções de membro que sobrecarregam operador>> são funções de entrada formatadas. 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 de entrada sem formatação. 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);

Os dois grupos de ligação de controle setstate(eofbit) se encontram o final do arquivo para extrair elementos.

Um objeto da classe basic_istream<Elem, Tr> armazena:

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

Exemplo

Consulte o exemplo de Classe basic_ifstream para obter mais informações sobre fluxos de entrada.

Construtores

basic_istream

Constrói um objeto de tipo basic_istream.

Funções de membro

gcount	Retorna o número de caracteres durante a entrada sem formatação a última vez.
obter	Ler um ou mais caracteres do fluxo de entrada.
getline	Lê uma linha do fluxo de entrada.
ignorar	Causa um número de elementos a ser ignorado da posição de leitura do atual.
verificação	Retorna o próximo caractere a ser lido.
putback	Coloca um caractere especificado no fluxo.
leitura	Lê um número especificado de caracteres de fluxo e armazená-los em uma matriz.
readsome	Somente leitura do buffer.
seekg	Move a posição de leitura em um fluxo.
sentinela	A classe aninhada descreve um objeto cuja declaração para as funções de entrada formatados e as funções de entrada sem formatação.
troca	Troca este objeto de basic_istream fornecido pelo parâmetro do objeto de basic_istream .
sincronização	Sincroniza o dispositivo de entrada associada com o fluxo com o buffer de fluxo.
tellg	Informa a posição de leitura do atual no fluxo.
unget	Coloca recentemente o caractere de leitura de novo no fluxo.

Operadores

operador>>	Chama uma função no fluxo de entrada ou ler dados formatados do fluxo de entrada.
operador=	Atribui basic_istream à direita do operador para este objeto. Essa é uma atribuição de movimentação que envolve uma referência de rvalue que não deixe uma cópia para trás.