Clase Platform::Collections::VectorIterator

Proporciona un iterador de la Biblioteca de plantillas estándar para los objetos derivados de la interfaz IVector de Windows Runtime.

VectorIterator es un iterador de proxy que almacena los elementos de tipo VectorProxy<T>. Sin embargo, el objeto proxy casi nunca está visible en el código del usuario. Para obtener más información, consulta Colecciones (C++/CX).

Sintaxis

template <typename T>
class VectorIterator;

Parámetros

T
El typename de la clase de plantilla VectorIterator.

Miembros

Definiciones de tipos públicas

Nombre	Descripción
difference_type	Una diferencia de puntero (ptrdiff_t).
iterator_category	Categoría de un iterador de acceso aleatorio (::std::random_access_iterator_tag).
pointer	Un puntero a un tipo interno, Platform::Collections::Details::VectorProxy<T>, necesario para la implementación de VectorIterator.
reference	Una referencia a un tipo interno, Platform::Collections::Details::VectorProxy<T>, necesario para la implementación de VectorIterator.
value_type	El typename T .

Constructores públicos

Nombre	Descripción
VectorIterator::VectorIterator	Inicializa una nueva instancia de la clase VectorIterator.

Operadores públicos

Nombre	Descripción
Operador VectorIterator::operator-	Resta un número especificado de elementos del iterador actual produciendo un nuevo iterador, o un iterador especificado del iterador actual produciendo el número de elementos entre los iteradores.
Operador VectorIterator::operator--	Disminuye el objeto VectorIterator actual.
Operador VectorIterator::operator!=	Indica si el objeto VectorIterator actual no es igual que un objeto VectorIterator especificado.
Operador VectorIterator::operator*	Recupera una referencia al elemento especificado por el objeto VectorIterator actual.
VectorIterator::operator[]	Recupera una referencia al elemento que es un desplazamiento especificado del objeto VectorIterator actual.
Operador VectorIterator::operator+	Devuelve un objeto VectorIterator que hace referencia al elemento en el desplazamiento especificado desde el objeto VectorIterator especificado.
Operador VectorIterator::operator++	Incrementa el objeto VectorIterator actual.
Operador VectorIterator::operator+=	Incrementa el objeto VectorIterator actual en el desplazamiento especificado.
Operador VectorIterator::operator<	Indica si el objeto VectorIterator actual es menor que un objeto VectorIterator especificado.
Operador VectorIterator::operator<=	Indica si el objeto VectorIterator actual es menor o igual que un objeto VectorIterator especificado.
Operador VectorIterator::operator-=	Disminuye el VectorIterator actual según el desplazamiento especificado.
Operador VectorIterator::operator==	Indica si el objeto VectorIterator actual es igual que un objeto VectorIterator especificado.
Operador VectorIterator::operator>	Indica si el objeto VectorIterator actual es mayor que un objeto VectorIterator especificado.
Operador VectorIterator::operator->	Recupera la dirección del elemento al que hace referencia el objeto VectorIterator actual.
Operador VectorIterator::operator>=	Indica si el objeto VectorIterator actual es mayor o igual que el objeto VectorIterator especificado.

Jerarquía de herencia

VectorIterator

Requisitos

Encabezado: collection.h

Espacio de nombres: Platform::Collections

Operador VectorIterator::operator->

Recupera la dirección del elemento al que hace referencia el objeto VectorIterator actual.

Sintaxis

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

Valor devuelto

Valor del elemento al que hace referencia el objeto VectorIterator actual.

El tipo del valor devuelto es un tipo interno no especificado que se requiere para la implementación de este operador.

Operador VectorIterator::operator--

Disminuye el objeto VectorIterator actual.

Sintaxis

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

Valor devuelto

La primera sintaxis disminuye y devuelve después el objeto VectorIterator actual. La segunda sintaxis devuelve una copia del objeto VectorIterator actual y disminuye después el objeto VectorIterator actual.

Comentarios

La primera sintaxis de VectorIterator disminuye previamente el objeto VectorIterator actual.

La segunda sintaxis disminuye posteriormente el objeto VectorIterator actual. El tipo int de la segunda sintaxis indica una operación de decremento posterior, no un operando entero real.

Operador VectorIterator::operator*

Recupera la dirección del elemento especificado por el objeto VectorIterator actual.

Sintaxis

reference operator*() const;

Valor devuelto

Elemento especificado por el objeto actual VectorIterator.

Operador VectorIterator::operator==

Determina si el objeto VectorIterator actual es igual a un objeto VectorIterator especificado.

Sintaxis

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

Parámetros

other
Otro VectorIterator.

Valor devuelto

Es true si el objeto VectorIterator actual es igual que other; de lo contrario, es false.

Operador VectorIterator::operator>

Determina si el objeto VectorIterator actual es mayor que un objeto VectorIterator especificado.

Sintaxis

bool operator>(const VectorIterator& other) const

Parámetros

other
Otro VectorIterator.

Valor devuelto

true si el objeto VectorIterator actual es mayor que other; de lo contrario, false.

Operador VectorIterator::operator>=

Indica si el objeto VectorIterator actual es mayor o igual que el objeto VectorIterator especificado.

Sintaxis

bool operator>=(const VectorIterator& other) const

Parámetros

other
Otro VectorIterator.

Valor devuelto

true si el objeto VectorIterator actual es mayor o igual que other; en caso contrario, false.

Operador VectorIterator::operator++

Incrementa el objeto actual VectorIterator.

Sintaxis

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

Valor devuelto

La primera sintaxis incrementa y devuelve después el objeto VectorIterator actual. La segunda sintaxis devuelve una copia del objeto VectorIterator actual e incrementa después el objeto VectorIterator actual.

Comentarios

La primera sintaxis VectorIterator incrementa previamente el objeto VectorIterator actual.

La segunda sintaxis incrementa posteriormente el objeto VectorIterator actual. El tipo int de la segunda sintaxis indica una operación de incremento posterior, no un operando entero real.

Operador VectorIterator::operator!=

Determina si el objeto VectorIterator actual no es igual al objeto VectorIterator especificado.

Sintaxis

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

Parámetros

other
Otro VectorIterator.

Valor devuelto

true si el objeto VectorIterator actual no es igual que other; en caso contrario, false.

Operador VectorIterator::operator<

Indica si el objeto VectorIterator actual es menor que un objeto VectorIterator especificado.

Sintaxis

bool operator<(const VectorIterator& other) const

Parámetros

other
Otro VectorIterator.

Valor devuelto

true si el objeto VectorIterator actual es menor que other; en caso contrario, false.

Operador VectorIterator::operator<=

Indica si el objeto VectorIterator actual es menor o igual que un objeto VectorIterator especificado.

Sintaxis

bool operator<=(const VectorIterator& other) const

Parámetros

other
Otro VectorIterator.

Valor devuelto

true si el objeto VectorIterator actual es menor o igual que other; en caso contrario, false.

Operador VectorIterator::operator-

Resta un número especificado de elementos del iterador actual produciendo un nuevo iterador, o un iterador especificado del iterador actual produciendo el número de elementos entre los iteradores.

Sintaxis

VectorIterator operator-(difference_type n) const;

difference_type operator-(const VectorIterator& other) const;

Parámetros

n
Número de elementos.

other
Otro VectorIterator.

Valor devuelto

La sintaxis del primer operador devuelve un objeto VectorIterator que tiene n elementos menos que el objeto VectorIterator actual. La segunda sintaxis del operador devuelve el número de elementos entre el actual y .other VectorIterator

Operador VectorIterator::operator+=

Incrementa el objeto VectorIterator actual en el desplazamiento especificado.

Sintaxis

VectorIterator& operator+=(difference_type n);

Parámetros

n
Desplazamiento entero.

Valor devuelto

VectorIterator actualizado.

Operador VectorIterator::operator+

Devuelve un objeto VectorIterator que hace referencia al elemento en el desplazamiento especificado desde el objeto VectorIterator especificado.

Sintaxis

VectorIterator operator+(difference_type n);

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

Parámetros

T
En la segunda sintaxis, el typename del objeto VectorIterator.

n
Desplazamiento entero.

i
En la segunda sintaxis, un objeto VectorIterator.

Valor devuelto

En la primera sintaxis, un objeto VectorIterator que hace referencia al elemento en el desplazamiento especificado desde el objeto VectorIterator actual.

En la segunda sintaxis, un objeto VectorIterator que hace referencia al elemento en el desplazamiento especificado desde el principio del parámetro i.

Comentarios

El ejemplo de la primera sintaxis

Operador VectorIterator::operator-=

Disminuye el VectorIterator actual según el desplazamiento especificado.

Sintaxis

VectorIterator& operator-=(difference_type n);

Parámetros

n
Desplazamiento entero.

Valor devuelto

VectorIterator actualizado.

Operador VectorIterator::operator[]

Recupera una referencia al elemento que es un desplazamiento especificado del objeto VectorIterator actual.

Sintaxis

reference operator[](difference_type n) const;

Parámetros

n
Desplazamiento entero.

Valor devuelto

El elemento que se desplaza n elementos del objeto VectorIterator actual.

Constructor VectorIterator::VectorIterator

Inicializa una nueva instancia de la clase VectorIterator.

Sintaxis

VectorIterator();

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

Parámetros

v
Objeto IVector<T>.

Comentarios

El primer ejemplo de sintaxis es el constructor predeterminado. El segundo ejemplo de sintaxis es un constructor explícito que se usa para construir un VectorIterator a partir de un objeto IVector<T>.

Consulte también

Espacio de nombres de plataforma