Classe Platform::Collections::Vector
Representa uma coleção sequencial de objetos que podem ser acessados separadamente por índice. Implementa Windows::Foundation::Collections::IObservableVector para ajudar na associação de dados XAML.
Sintaxe
template <typename T, typename E>
ref class Vector sealed;
Parâmetros
T
O tipo dos elementos contidos no objeto Vector.
E
Especifica um predicado binário para testar a igualdade com valores do tipo T. O valor padrão é std::equal_to<T>.
Comentários
Os tipos permitidos são:
integers
classe interface^
classe ref pública^
value struct
classe de enum pública
A classe Vector é a implementação concreta de C++ da interface Windows::Foundation::Collections::IVector.
Se você tentar usar um tipo Vector em um parâmetro ou valor retornado público, o erro do compilador C3986 será gerado. Você pode corrigir o erro alterando o tipo do parâmetro ou do valor de retorno para Windows::Foundation::Collections::IVector. Para obter mais informações, consulte Coleções (C++/CX).
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| Vector::Vector | Inicializa uma nova instância da classe Vector. |
Métodos públicos
| Nome | Descrição |
|---|---|
| Vetor::Anexar | Insere o item especificado após o último item no Vector atual. |
| Vector::Clear | Exclui todos os elementos no Vector atual. |
| Vector::First | Retorna um iterador que especifica o primeiro elemento em Vector. |
| Vector::GetAt | Recupera o elemento de Vector atual que é identificado pelo índice especificado. |
| Vector::GetMany | Recupera uma sequência de itens de Vector atual, começando no índice especificado. |
| Vector::GetView | Retorna uma exibição somente leitura de um Vector; isto é, um Platform::Collections::VectorView. |
| Vector::IndexOf | Procura o item especificado no vetor atual, e se encontrado, retorna o índice do item. |
| Vetor::InsertAt | Insere o item especificado no Vector atual no elemento identificado pelo índice especificado. |
| Vetor::ReplaceAll | Exclui os elementos no Vector atual e insere os elementos da matriz especificada. |
| Vetor::RemoveAt | Exclui o elemento identificado pelo índice especificado do Vector atual. |
| Vetor::RemoveAtEnd | Exclui o elemento no final do Vector atual. |
| Vetor::SetAt | Atribui o valor especificado ao elemento no Vector atual que é identificado pelo índice especificado. |
| Vector::Size | Retorna o número de elementos no objeto Vector atual. |
Eventos
| Nome | Descrição |
|---|---|
| event Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged | Ocorre quando o Vector é alterado. |
Hierarquia de herança
Vector
Requisitos
Cabeçalho: collection.h
Namespace: Platform::Collections
Método Vector::Append
Insere o item especificado após o último item no Vector atual.
Sintaxe
virtual void Append(T item);
Parâmetros
index
O item a ser inserido no Vector. O tipo do item é definido pelo typename T.
Método Vector::Clear
Exclui todos os elementos no Vector atual.
Sintaxe
virtual void Clear();
Método Vector::First
Retorna um iterador que aponta para o primeiro elemento em Vector.
Sintaxe
virtual Windows::Foundation::Collections::IIterator <T>^ First();
Valor retornado
Um iterador que aponta para o primeiro elemento em Vector.
Comentários
Uma maneira conveniente de manter o iterador retornado por First() é atribuir o valor retornado a uma variável declarada com a palavra-chave de dedução do tipo auto. Por exemplo, auto x = myVector->First();. Este iterador conhece a duração da coleta.
Quando você precisar de um par de iteradores para passar a uma função STL, use as funções gratuitas Windows::Foundation::Collections::begin e Windows::Foundation::Collections::end
Método Vector::GetAt
Recupera o elemento de Vector atual que é identificado pelo índice especificado.
Sintaxe
virtual T GetAt(unsigned int index);
Parâmetros
index
Um inteiro não assinado com base zero que especifica um determinado elemento no objeto Vector.
Valor de retorno
O elemento especificado pelo parâmetro index. O tipo de elemento é definido pelo typename T.
Método Vector::GetMany
Recupera uma sequência de itens de Vector atual, começando a partir do índice especificado e os copia na matriz alocada pelo chamador.
Sintaxe
virtual unsigned int GetMany(
unsigned int startIndex,
Platform::WriteOnlyArray<T>^ dest);
Parâmetros
startIndex
O índice com base zero do início dos itens a serem recuperados.
dest
Uma matriz de itens alocada pelo chamador, que inicia no elemento especificado por startIndex e termina no último elemento no Vector.
Valor de retorno
O número de itens recuperados.
Comentários
Esta função não se destina a ser usada diretamente pelo código do cliente. Ela é usada internamente na Função to_vector para habilitar uma conversão eficiente das instâncias Platform::Vector em instâncias std::vector.
Método Vector::GetView
Retorna uma exibição somente leitura de um Vector; isto é, um IVectorView.
Sintaxe
Windows::Foundation::Collections::IVectorView<T>^ GetView();
Valor retornado
Um objeto IVectorView.
Método Vector::IndexOf
Procura o item especificado no vetor atual, e se encontrado, retorna o índice do item.
Sintaxe
virtual bool IndexOf(T value, unsigned int* index);
Parâmetros
value
O item a ser localizado.
index
O índice com base zero do item se o parâmetro value for encontrado; caso contrário, 0.
O parâmetro index será 0 se o item for o primeiro elemento do Vector ou se o item não for encontrado. Se o valor de retorno for true, o item foi encontrado e é o primeiro elemento; caso contrário, o item não foi encontrado.
Valor de retorno
true se o item especificado for encontrado; caso contrário, false.
Comentários
O IndexOf usa o std::find_if para encontrar o item. Tipos de elementos personalizados deverão, portanto, sobrecarregar os operadores == e != para habilitar as comparações de igualdade exigidas por find_if.
Método Vector::InsertAt
Insere o item especificado no Vector atual no elemento identificado pelo índice especificado.
Sintaxe
virtual void InsertAt(unsigned int index, T item)
Parâmetros
index
Um inteiro não assinado com base zero que especifica um determinado elemento no objeto Vector.
item
Para inserir um item no Vector após o elemento especificado por index. O tipo do item é definido pelo typename T.
Método Vector::RemoveAt
Exclui o elemento identificado pelo índice especificado do Vector atual.
Sintaxe
virtual void RemoveAt(unsigned int index);
Parâmetros
index
Um inteiro não assinado com base zero que especifica um determinado elemento no objeto Vector.
Método Vector::RemoveAtEnd
Exclui o elemento no final do Vector atual.
Sintaxe
virtual void RemoveAtEnd();
Método Vector::ReplaceAll
Exclui os elementos no Vector atual e insere os elementos da matriz especificada.
Sintaxe
virtual void ReplaceAll(const ::Platform::Array<T>^ arr);
Parâmetros
arr
Uma matriz de objetos cujo tipo é definido pelo typename T.
Método Vector::SetAt
Atribui o valor especificado ao elemento no Vector atual que é identificado pelo índice especificado.
Sintaxe
virtual void SetAt(unsigned int index, T item);
Parâmetros
index
Um inteiro não assinado com base zero que especifica um determinado elemento no objeto Vector.
item
O valor a ser atribuído ao elemento especificado. O tipo do item é definido pelo typename T.
Método Vector::Size
Retorna o número de elementos no objeto Vector atual.
Sintaxe
virtual property unsigned int Size;
Valor retornado
O número de elementos no Vector atual.
Construtor Vector::Vector
Inicializa uma nova instância da classe Vector.
Sintaxe
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
Um std::array que será usado para inicializar o Vector.
arr
Um Platform::Array que será usado para inicializar o Vector.
InIt
O tipo de uma coleção de objetos que é usada para inicializar o Vector atual.
il
Um std::initializer_list de objetos do tipo T que será usado para inicializar o Vector.
N
O número de elementos em uma coleção de objetos que é usada para inicializar o Vector atual.
size
O número de elementos no Vector.
value
Um valor que é usado para inicializar cada elemento no Vector atual.
v
Um Lvalues e Rvalues para um std::vector que é usado para inicializar o Vector atual.
ptr
Ponteiro para um std::vector que é usado para inicializar o Vector atual.
first
O primeiro elemento em uma sequência de objetos que é usado para inicializar o Vector atual. O tipo de first é passado por meio de encaminhamento perfeito. Para obter mais informações, consulte Declarador de referência Rvalue: &&.
last
O último elemento em uma sequência de objetos que é usado para inicializar o Vector atual. O tipo de last é passado por meio de encaminhamento perfeito. Para obter mais informações, consulte Declarador de referência Rvalue: &&.
Confira também
Coleções (C++/CX)
Namespace de Plataforma
Criando componentes do Windows Runtime no C++