Platform::Collections::Vector (Clase)
Representa una colección secuencial de objetos a los que se puede tener acceso individualmente por un índice. Implementa Windows::Foundation::Collections::IObservableVector para ayudar con el enlace de datos de XAML.
Sintaxis
template <typename T, typename E>
ref class Vector sealed;
Parámetros
T
Tipo de los elementos contenidos en el objeto Vector.
E
Especifica un predicado binario para probar la igualdad con valores de tipo T. El valor predeterminado es std::equal_to<T>.
Comentarios
Los tipos permitidos son:
integers
clase interface^
clase ref pública^
value struct
clase de enumeración pública
La clase Vector es la implementación concreta de C++ de la interfaz Windows::Foundation::Collections::IVector.
Si intenta usar un tipo Vector en un valor devuelto o parámetro público, se producirá el error del compilador C3986. Puedes corregir el error si cambias el tipo del parámetro o del valor devuelto a Windows::Foundation::Collections::IVector. Para obtener más información, consulta Colecciones (C++/CX).
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| Vector::Vector | Inicializa una nueva instancia de la clase Vector. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| Vector::Append | Inserta el elemento especificado a continuación del último elemento en el objeto Vector actual. |
| Vector::Clear | Elimina todos los elementos del Vector actual. |
| Vector::First | Devuelve un iterador que especifica el primer elemento del objeto Vector. |
| Vector::GetAt | Recupera el elemento del objeto Vector actual identificado por el índice especificado. |
| Vector::GetMany | Recupera una secuencia de elementos del objeto Vector actual, empezando en el índice especificado. |
| Vector::GetView | Devuelve una vista de solo lectura de una clase Vector; es decir, Platform::Collections::VectorView. |
| Vector::IndexOf | Busca el elemento especificado en el objeto Vector actual y, si lo encuentra, devuelve el índice del elemento. |
| Vector::InsertAt | Inserta el elemento especificado en el objeto Vector actual en el elemento identificado por el índice especificado. |
| Vector::ReplaceAll | Elimina los elementos del objeto Vector actual y después inserta los elementos de la matriz especificada. |
| Vector::RemoveAt | Elimina el elemento identificado por el índice especificado del objeto Vector actual. |
| Vector::RemoveAtEnd | Elimina el elemento al final del objeto Vector actual. |
| Vector::SetAt | Asigna el valor especificado al elemento del objeto Vector actual identificado por el índice especificado. |
| Vector::Size | Devuelve el número de elementos del objeto Vector actual. |
Eventos
| Nombre | Descripción |
|---|---|
| event Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged | Se produce cuando cambia el objeto Vector. |
Jerarquía de herencia
Vector
Requisitos
Encabezado: collection.h
Espacio de nombres: Platform::Collections
Vector::Append (Método)
Inserta el elemento especificado a continuación del último elemento en el objeto Vector actual.
Sintaxis
virtual void Append(T item);
Parámetros
índice
El elemento que se va a insertar en el objeto Vector. El tipo de item se define mediante el typename T.
Vector::Clear (Método)
Elimina todos los elementos del Vector actual.
Sintaxis
virtual void Clear();
Vector::First (Método)
Devuelve un iterador que apunta al primer elemento del objeto Vector.
Sintaxis
virtual Windows::Foundation::Collections::IIterator <T>^ First();
Valor devuelto
Un iterador que apunta al primer elemento del objeto Vector.
Comentarios
Una manera cómoda de contener el iterador devuelto por First() es asignar el valor devuelto a una variable que se declara con la palabra clave de deducción de tipos auto. Por ejemplo, auto x = myVector->First();. El iterador conoce la longitud de la colección.
Si necesita un par de iteradores para pasar a una función STL, utilice las funciones libres Windows::Foundation::Collections::begin y Windows::Foundation::Collections::end.
Vector::GetAt (Método)
Recupera el elemento del objeto Vector actual identificado por el índice especificado.
Sintaxis
virtual T GetAt(unsigned int index);
Parámetros
índice
Entero sin signo de base cero que especifica un elemento determinado en el objeto Vector.
Valor devuelto
Elemento especificado por el parámetro index. El tipo de elemento se define mediante el typename T.
Vector::GetMany (Método)
Recupera una secuencia de elementos del objeto Vector actual, empezando en el índice especificado, y los copia en la matriz asignada por el llamador.
Sintaxis
virtual unsigned int GetMany(
unsigned int startIndex,
Platform::WriteOnlyArray<T>^ dest);
Parámetros
startIndex
Índice basado en cero del principio de los elementos que se van a recuperar.
dest
Matriz de elementos asignada por el llamador que empieza con el elemento especificado por startIndex y termina con el último elemento del objeto Vector.
Valor devuelto
Número de elementos recuperados.
Comentarios
Esta función no se ha diseñado para el uso en el código de cliente. Se usa internamente en la función to_vector para habilitar la conversión eficaz de instancias Platform::Vector a instancias std::vector.
Vector::GetView (Método)
Devuelve una vista de solo lectura de un objeto Vector; es decir, una interfaz IVectorView.
Sintaxis
Windows::Foundation::Collections::IVectorView<T>^ GetView();
Valor devuelto
Un objeto IVectorView.
Vector::IndexOf (Método)
Busca el elemento especificado en el objeto Vector actual y, si lo encuentra, devuelve el índice del elemento.
Sintaxis
virtual bool IndexOf(T value, unsigned int* index);
Parámetros
value
El elemento que se va a buscar.
índice
El índice de base cero del elemento si se encuentra el parámetro value; en caso contrario, 0.
El parámetro index es 0 si el elemento es el primer elemento del objeto Vector o no se encuentra el elemento. Si el valor devuelto es true, se encontró el elemento y es el primer elemento; de lo contrario, no se encontró el elemento.
Valor devuelto
true si se encontró el elemento especificado; de lo contrario, false.
Comentarios
IndexOf utiliza std::find_if para buscar el elemento. Por tanto, los tipos de elementos personalizados deben sobrecargar los operadores == y != para habilitar las comparaciones de igualdad que requiere find_if.
Vector::InsertAt (Método)
Inserta el elemento especificado en el objeto Vector actual en el elemento identificado por el índice especificado.
Sintaxis
virtual void InsertAt(unsigned int index, T item)
Parámetros
índice
Entero sin signo de base cero que especifica un elemento determinado en el objeto Vector.
item
Elemento que se va a insertar en el objeto Vector en el elemento especificado por index. El tipo de item se define mediante el typename T.
Vector::RemoveAt (Método)
Elimina el elemento identificado por el índice especificado del objeto Vector actual.
Sintaxis
virtual void RemoveAt(unsigned int index);
Parámetros
índice
Entero sin signo de base cero que especifica un elemento determinado en el objeto Vector.
Vector::RemoveAtEnd (Método)
Elimina el elemento al final del objeto Vector actual.
Sintaxis
virtual void RemoveAtEnd();
Vector::ReplaceAll (Método)
Elimina los elementos del objeto Vector actual y después inserta los elementos de la matriz especificada.
Sintaxis
virtual void ReplaceAll(const ::Platform::Array<T>^ arr);
Parámetros
arr
Matriz de objetos cuyo tipo está definido por el typename T.
Vector::SetAt (Método)
Asigna el valor especificado al elemento del objeto Vector actual identificado por el índice especificado.
Sintaxis
virtual void SetAt(unsigned int index, T item);
Parámetros
índice
Entero sin signo de base cero que especifica un elemento determinado en el objeto Vector.
item
El valor que se va a asignar al elemento especificado. El tipo de item se define mediante el typename T.
Vector::Size (Método)
Devuelve el número de elementos del objeto Vector actual.
Sintaxis
virtual property unsigned int Size;
Valor devuelto
Número de elementos del Vector actual.
Vector::Vector (Constructor)
Inicializa una nueva instancia de la clase Vector.
Sintaxis
Vector();
explicit Vector(unsigned int size);
Vector( unsigned int size, T value);
template <typename U> explicit Vector( const ::std::vector<U>& v);
template <typename U> explicit Vector( std::vector<U>&& v);
Vector( const T * ptr, unsigned int size);
template <size_t N> explicit Vector(const T(&arr)[N]);
template <size_t N> explicit Vector(const std::array<T, N>& a);
explicit Vector(const Array<T>^ arr);
template <typename InIt> Vector(InIt first, InIt last);
Vector(std::initializer_list<T> il);
Parámetros
a
Objeto std::array que se usa para inicializar la clase Vector.
arr
Objeto Platform::Array que se usa para inicializar la clase Vector.
InIt
El tipo de una colección de objetos que se utiliza para inicializar el objeto Vector actual.
il
std::initializer_list de los objetos de tipo T que se van a utilizar para inicializar la clase Vector.
N.
El número de elementos en una colección de objetos que se utiliza para inicializar el objeto Vector actual.
size
El número de elementos del objeto Vector.
value
Un valor que se utiliza para inicializar cada elemento en el objeto Vector actual.
v
Un elemento Lvalues y Rvalues a un elemento std::vector que se usa para inicializar el objeto Vector actual.
ptr
Puntero a un objeto std::vector que se usa para inicializar el objeto Vector actual.
first
El primer elemento de una secuencia de objetos que se utilizan para inicializar el objeto Vector actual. El tipo de first se pasa mediante reenvío directo. Para más información, vea Declarador de referencia a un valor R: &&.
last
El último elemento de una secuencia de objetos que se utilizan para inicializar el objeto Vector actual. El tipo de last se pasa mediante reenvío directo. Para más información, vea Declarador de referencia a un valor R: &&.
Consulte también
Colecciones (C++/CX)
Espacio de nombres de plataforma
Crear componentes de Windows Runtime en C++