Classe Platform::Collections::VectorIterator

Fornece um iterador da Biblioteca de Modelos Padrão para objetos derivados da interface IVector do Windows Runtime.

VectorIterator é um iterador proxy que armazena elementos do tipo VectorProxy<T>. Entretanto, o objeto proxy quase nunca é visível ao código do usuário. Para obter mais informações, consulte Coleções (C++/CX).

Sintaxe

template <typename T>
class VectorIterator;

Parâmetros

T
O typename da classe de modelo VectorIterator.

Membros

Typedefs públicos

Nome	Descrição
difference_type	Uma diferença de ponteiro (ptrdiff_t).
iterator_category	A categoria de um iterador de acesso aleatório (::std::random_access_iterator_tag).
pointer	Um ponteiro para um tipo interno, Platform::Collections::Details::VectorProxy<T>, necessário para a implementação de VectorIterator.
reference	Uma referência para um tipo interno, Platform::Collections::Details::VectorProxy<T>, necessário para a implementação de VectorIterator.
value_type	O typename T .

Construtores públicos

Nome	Descrição
VectorIterator::VectorIterator	Inicializa uma nova instância da classe VectorIterator.

Operadores públicos

Nome	Descrição
VectorIterator::operator- Operador	Subtrai um número especificado de elementos do iterador atual, gerando um novo iterador, ou um iterador especificado do iterador atual, gerando o número de elementos entre os iteradores.
VectorIterator::operator-- Operador	Decrementa o VectorIterator atual.
VectorIterator::operator!= Operador	Indica se o VectorIterator atual não é igual a um VectorIterator especificado.
VectorIterator::operator* Operador	Recupera uma referência ao elemento especificado pelo VectorIterator atual.
VectorIterator::operator[]	Recupera uma referência ao elemento que é um deslocamento especificado de VectorIterator atual.
VectorIterator::operator+ Operador	Retorna um VectorIterator que referencia o elemento no deslocamento especificado do VectorIterator especificado.
VectorIterator::operator++ Operador	Incrementa o VectorIterator atual.
VectorIterator::operator+= Operador	Incrementa o VectorIterator atual pelo deslocamento especificado.
VectorIterator::operator< Operador	Indica se o VectorIterator atual é menor que um VectorIterator especificado.
VectorIterator::operator<= Operador	Indica se o VectorIterator atual é menor ou igual a um VectorIterator especificado.
VectorIterator::operator-= Operador	Decrementa o VectorIterator atual pelo deslocamento especificado.
VectorIterator::operator== Operador	Indica se o VectorIterator atual é igual a um VectorIterator especificado.
VectorIterator::operator> Operador	Indica se o VectorIterator atual é maior que um VectorIterator especificado.
VectorIterator::operator-> Operador	Recupera o endereço do elemento referenciado pelo VectorIterator atual.
VectorIterator::operator>= Operador	Indica se o VectorIterator atual é maior ou igual a um VectorIterator especificado.

Hierarquia de herança

VectorIterator

Requisitos

Cabeçalho: collection.h

Namespace: Platform::Collections

Operador VectorIterator::operator->

Recupera o endereço do elemento referenciado pelo VectorIterator atual.

Sintaxe

Detail::ArrowProxy<T> operator->() const;

Valor retornado

O valor do elemento referenciado pelo VectorIterator atual.

O tipo do valor retornado é um tipo interno não especificado que é necessário para a implementação desse operador.

Operador VectorIterator::operator--

Decrementa o VectorIterator atual.

Sintaxe

VectorIterator& operator--();
VectorIterator operator--(int);

Valor retornado

A primeira sintaxe decrementa e, em seguida, retorna o VectorIterator atual. A segunda sintaxe retorna uma cópia do VectorIterator atual e, em seguida, decrementa o VectorIterator atual.

Comentários

A primeira sintaxe de VectorIterator decrementa previamente o VectorIterator atual.

A segunda sintaxe pós-diminui o VectorIterator atual. O tipo int na segunda sintaxe indica uma operação de pós-diminuição, não um operando de inteiro real.

Operador VectorIterator::operator*

Recupera o endereço do elemento especificado pelo VectorIterator atual.

Sintaxe

reference operator*() const;

Valor retornado

O elemento especificado pelo VectorIterator atual.

Operador VectorIterator::operator==

Indica se o VectorIterator atual é igual a um VectorIterator especificado.

Sintaxe

bool operator==(const VectorIterator& other) const;

Parâmetros

other
Outro VectorIterator.

Valor de retorno

true se o VectorIterator atual for igual a outro; caso contrário, false.

Operador VectorIterator::operator>

Indica se o VectorIterator atual é maior que um VectorIterator especificado.

Sintaxe

bool operator>(const VectorIterator& other) const

Parâmetros

other
Outro VectorIterator.

Valor de retorno

true se o VectorIterator atual é maior que other; caso contrário, false.

Operador VectorIterator::operator>=

Indica se o VectorIterator atual é maior que ou igual ao VectorIterator especificado.

Sintaxe

bool operator>=(const VectorIterator& other) const

Parâmetros

other
Outro VectorIterator.

Valor de retorno

true se o VectorIterator atual é maior que ou igual a other; caso contrário, false.

Operador VectorIterator::operator++

Incrementa o VectorIterator atual.

Sintaxe

VectorIterator& operator++();
VectorIterator operator++(int);

Valor retornado

A primeira sintaxe incrementa e, em seguida, retorna o VectorIterator atual. A segunda sintaxe retorna uma cópia do VectorIterator atual e, em seguida, incrementa o VectorIterator atual.

Comentários

A primeira sintaxe VectorIterator incrementa previamente o VectorIterator atual.

A segunda sintaxe incrementa o VectorIterator posteriormente. O tipo int na segunda sintaxe indica uma operação de pós-incremento, não um operando de inteiro real.

Operador VectorIterator::operator!=

Indica se o VectorIterator atual é diferente de um VectorIterator especificado.

Sintaxe

bool operator!=(const VectorIterator& other) const;

Parâmetros

other
Outro VectorIterator.

Valor de retorno

true se o VectorIterator atual não for igual a other; caso contrário, false.

Operador VectorIterator::operator<

Indica se o VectorIterator atual é menor que um VectorIterator especificado.

Sintaxe

bool operator<(const VectorIterator& other) const

Parâmetros

other
Outro VectorIterator.

Valor de retorno

true se o VectorIterator atual é menor que other; caso contrário, false.

Operador VectorIterator::operator<=

Indica se o VectorIterator atual é menor ou igual a um VectorIterator especificado.

Sintaxe

bool operator<=(const VectorIterator& other) const

Parâmetros

other
Outro VectorIterator.

Valor de retorno

true se o VectorIterator atual é menor que ou igual a other; caso contrário, false.

Operador VectorIterator::operator-

Subtrai um número especificado de elementos do iterador atual, gerando um novo iterador, ou um iterador especificado do iterador atual, gerando o número de elementos entre os iteradores.

Sintaxe

VectorIterator operator-(difference_type n) const;

difference_type operator-(const VectorIterator& other) const;

Parâmetros

n
Um número de elementos.

other
Outro VectorIterator.

Valor de retorno

A primeira sintaxe do operador retorna um objeto VectorIterator que corresponde a elementos n menores o VectorIterator atual. A sintaxe do segundo operador retorna o número de elementos entre o atual e o .other VectorIterator

Operador VectorIterator::operator+=

Incrementa o VectorIterator atual pelo deslocamento especificado.

Sintaxe

VectorIterator& operator+=(difference_type n);

Parâmetros

n
Um deslocamento de inteiro.

Valor de retorno

O VectorIterator atualizado.

Operador VectorIterator::operator+

Retorna um VectorIterator que referencia o elemento no deslocamento especificado do VectorIterator especificado.

Sintaxe

VectorIterator operator+(difference_type n);

template <typename T>
inline VectorIterator<T> operator+(
  ptrdiff_t n,
  const VectorIterator<T>& i);

Parâmetros

T
Na segunda sintaxe, o typename de VectorIterator.

n
Um deslocamento de inteiro.

i
Na segunda sintaxe, um VectorIterator.

Valor de retorno

Na primeira sintaxe, um VectorIterator que referencia o elemento no deslocamento especificado do VectorIterator atual.

Na segunda sintaxe, um VectorIterator que referencia o elemento no deslocamento especificado do início do parâmetro i.

Comentários

O primeiro exemplo de sintaxe

Operador VectorIterator::operator-=

Decrementa o VectorIterator atual pelo deslocamento especificado.

Sintaxe

VectorIterator& operator-=(difference_type n);

Parâmetros

n
Um deslocamento de inteiro.

Valor de retorno

O VectorIterator atualizado.

Operador VectorIterator::operator[]

Recupera uma referência ao elemento que é um deslocamento especificado do VectorIterator atual.

Sintaxe

reference operator[](difference_type n) const;

Parâmetros

n
Um deslocamento de inteiro.

Valor de retorno

O elemento deslocado pelos elementos n do VectorIterator atual.

Construtor VectorIterator::VectorIterator

Inicializa uma nova instância da classe VectorIterator.

Sintaxe

VectorIterator();

explicit VectorIterator(
   Windows::Foundation::Collections::IVector<T>^ v);

Parâmetros

v
Um objeto IVector<T>.

Comentários

O primeiro exemplo de sintaxe é o construtor padrão. O segundo exemplo de sintaxe é um construtor explícito usado para construir um VectorIterator com um objeto IVector<T>.

Confira também

Namespace de Plataforma