Classe istream_iterator

Artigo
06/09/2015

Descreve um objeto de iterador de entrada. Extrai objetos da classe Type de um fluxo de entrada, que acessa por meio de um objeto que armazena, do tipo pointer para basic_istream<CharType, Traits>.

template<class Type,
    class CharType = char,
    class Traits = char_traits<CharType>,
    class Distance = ptrdiff_t,
> class istream_iterator
 : public iterator<
        input_iterator_tag,
        Type, 
        Distance, 
        const Type *,
        const Type&
    >;

Parâmetros

Type
O tipo de objeto a ser extraído do fluxo de entrada.
CharType
O tipo que representa o tipo de caractere para istream_iterator. Esse argumento é opcional e o valor padrão é char.
Traits
O tipo que representa o tipo de caractere para istream_iterator. Esse argumento é opcional e o valor padrão é char_traits<CharType>.
Distance
Um tipo integral com sinal que representa o tipo de diferença para istream_iterator. Esse argumento é opcional e o valor padrão é ptrdiff_t.

Depois de construir ou incrementar um objeto da classe istream_iterator com um ponteiro armazenado não nulo, o objeto tenta extrair e armazenar um objeto do tipo Type do fluxo de entrada associado. Se a extração falhar, o objeto substitui eficientemente o ponteiro armazenado por um ponteiro nulo, criando um indicador de fim de sequência.

Construtores

istream_iterator

Constrói um iterador de fim de fluxo como o istream_iterator padrão ou um istream_iterator inicializado para o tipo de fluxo do iterador do qual ele lê.

Typedefs

char_type	Um tipo que é fornecido para o tipo de caractere do istream_iterator.
istream_type	Um tipo que é fornecido para o tipo de fluxo da istream_iterator.
traits_type	Um tipo que fornece o tipo de característica do caractere da istream_iterator.

Operadores

operator*	O operador de desreferenciamento retorna o objeto armazenado do tipo Type tratado por istream_iterator.
operator->	Retorna o valor de um membro, se houver.
operator++	Ou extrai um objeto incrementado do fluxo de entrada, ou copia o objeto antes de incrementá-lo e retorna a cópia.