Classe istreambuf_iterator

A classe de modelo istreambuf_iterator descreve um objeto de iterador de entrada que extrai elementos de caractere de um buffer de fluxo de entrada, que acessa por meio de um objeto que armazena, do tipo ponteiro para basic_streambuf<CharType, Traits>.

template <  
   class CharType 
   class Traits = char_traits<CharType> 
> 
class istreambuf_iterator 
: public iterator<input_iterator_tag, CharType, typename Traits::off_type, CharType *, CharType&>

Parâmetros

• CharType
  O tipo que representa o tipo de caractere para istreambuf_iterator.

• Traits
  O tipo que representa o tipo de caractere para istreambuf_iterator. Esse argumento é opcional e o valor padrão é char_traits<CharType>.

Comentários

A classe istreambuf_iterator deve atender aos requisitos de um iterador de entrada.

Depois de construir ou incrementar um objeto da classe istreambuf_iterator com um ponteiro armazenado não nulo, o objeto tenta eficientemente extrair e armazenar um objeto do tipo CharType do fluxo de entrada associado. A extração pode ser atrasada, no entanto, até que o objeto seja de fato desreferenciado ou copiado. 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

istreambuf_iterator

Constrói uma istreambuf_iterator que é inicializada para ler caracteres do fluxo de entrada.

Typedefs

char_type	Um tipo que é fornecido para o tipo de caractere do ostreambuf_iterator.
int_type	Um tipo que fornece um tipo de inteiro para uma istreambuf_iterator.
istream_type	Um tipo que é fornecido para o tipo de fluxo da istream_iterator.
streambuf_type	Um tipo que é fornecido para o tipo de fluxo da istreambuf_iterator.
traits_type	Um tipo que fornece o tipo de característica do caractere da istream_iterator.

Funções membro

equal

Testa a igualdade entre dois iteradores do buffer de fluxo de entrada.

Operadores

operator*	O operador de desreferenciamento retorna o próximo caractere no fluxo.
operator++	Ou retorna o próximo caracteres do fluxo de entrada, ou copia o objeto antes de incrementá-lo e retorna a cópia.
operator->	Retorna o valor de um membro, se houver.

Requisitos

Cabeçalho: <iterator>

Namespace: std

Consulte também

Referência

Struct iterator

<iterator>

Segurança de threads na Biblioteca Padrão C++

Biblioteca de Modelos Padrão