Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Representa uma coleção sequencial de objetos que podem ser acessados individualmente pelo índice. Implementa Windows::Foundation::Collections::IObservableVector para ajudar com a vinculação de dados XAML.
Sintaxe
template <typename T, typename E>
ref class Vector sealed;
Parâmetros
T
O tipo dos elementos contidos no objeto Vetor.
E
Especifica um predicado binário para testar a igualdade com valores do tipo T. O valor padrão é std::equal_to<T>.
Observações
Os tipos permitidos são:
Números inteiros
classe de interface^
classe ref pública^
valor struct
Classe Enum Público
A classe Vetor é a implementação concreta C++ da interface Windows::Foundation::Collections::IVector .
Se você tentar usar um tipo de vetor em um valor de retorno público ou parâmetro, o erro de compilador C3986 é gerado. Você pode corrigir o erro alterando o parâmetro ou o tipo de valor de retorno para Windows::Foundation::Collections::IVector. Para obter mais informações, consulte Coleções (C++/CX).
Members
Construtores Públicos
| Nome | Description |
|---|---|
| Vetor::Vetor | Inicializa uma nova instância da classe Vetor. |
Métodos Públicos
| Nome | Description |
|---|---|
| Vetor::Acrescentar | Insere o item especificado após o último item no vetor atual. |
| Vetor::Limpar | Exclui todos os elementos no vetor atual. |
| Vetor::Primeiro | Retorna um iterador que especifica o primeiro elemento no vetor. |
| Vetor::GetAt | Recupera o elemento do vetor atual que é identificado pelo índice especificado. |
| Vetor::GetMany | Recupera uma sequência de itens do vetor atual, começando no índice especificado. |
| Vetor::GetView | Retorna uma exibição somente leitura de um vetor; ou seja, um Platform::Collections::VectorView. |
| Vetor::IndexOf | Procura o item especificado no vetor atual e, se encontrado, retorna o índice do item. |
| Vetor::InsertAt | Insere o item especificado no vetor atual no elemento identificado pelo índice especificado. |
| Vetor::ReplaceAll | Exclui os elementos no vetor atual e, em seguida, insere os elementos da matriz especificada. |
| Vetor::RemoveAt | Exclui o elemento identificado pelo índice especificado do vetor atual. |
| Vetor::RemoveAtEnd | Exclui o elemento no final do vetor atual. |
| Vetor::SetAt | Atribui o valor especificado ao elemento no vetor atual que é identificado pelo índice especificado. |
| Vetor::Tamanho | Retorna o número de elementos no objeto Vetor atual. |
Events
| Nome | Description |
|---|---|
| evento Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged | Ocorre quando o vetor muda. |
Hierarquia de herança
Vector
Requerimentos
Cabeçalho: collection.h
Espaço de nomes: Plataforma::Coleções
Método Vetor::Append
Insere o item especificado após o último item no vetor atual.
Sintaxe
virtual void Append(T item);
Parâmetros
índice
O item a ser inserido no vetor. O tipo de item é definido pelo nome do tipo T .
Método Vetor::Clear
Exclui todos os elementos no vetor atual.
Sintaxe
virtual void Clear();
Vetor::Primeiro Método
Retorna um iterador que aponta para o primeiro elemento no vetor.
Sintaxe
virtual Windows::Foundation::Collections::IIterator <T>^ First();
Valor de retorno
Um iterador que aponta para o primeiro elemento no vetor.
Observações
Uma maneira conveniente de manter o iterador retornado por First() é atribuir o valor de retorno a uma variável que é declarada com a palavra-chave de dedução de auto tipo. Por exemplo, auto x = myVector->First();. Este iterador conhece o comprimento da coleção.
Quando você precisar de um par de iteradores para passar para uma função STL, use as funções livres Windows::Foundation::Collections::begin e Windows::Foundation::Collections::end
Método Vetor::GetAt
Recupera o elemento do vetor atual que é identificado pelo índice especificado.
Sintaxe
virtual T GetAt(unsigned int index);
Parâmetros
índice
Um inteiro não assinado baseado em zero que especifica um elemento específico no objeto Vetor.
Valor de retorno
O elemento especificado pelo parâmetro index . O tipo de elemento é definido pelo typename T .
Método Vetor::GetMany
Recupera uma sequência de itens do vetor atual, começando no índice especificado, e os copia para a matriz alocada pelo chamador.
Sintaxe
virtual unsigned int GetMany(
unsigned int startIndex,
Platform::WriteOnlyArray<T>^ dest);
Parâmetros
startIndex
O índice baseado em zero do início dos itens a serem recuperados.
dest
Uma matriz alocada pelo chamador de itens que começam no elemento especificado por startIndex e terminam no último elemento no Vetor.
Valor de retorno
O número de itens recuperados.
Observações
Esta função não se destina a ser usada diretamente pelo código do cliente. Ele é usado internamente na função to_vetor para permitir a conversão eficiente de instâncias Platform::Vetor para instâncias std::vetor.
Método Vetor::GetView
Retorna uma exibição somente leitura de um vetor; ou seja, um IVectorView.
Sintaxe
Windows::Foundation::Collections::IVectorView<T>^ GetView();
Valor de retorno
Um objeto IVectorView.
Método Vetor::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 encontrado.
índice
O índice baseado em zero do item se o valor do parâmetro for encontrado; caso contrário, 0.
O parâmetro index é 0 se o item for o primeiro elemento do Vetor ou se o item não foi 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.
Observações
IndexOf usa std::find_if para localizar o item. Os tipos de elementos personalizados devem, portanto, sobrecarregar o operador == e != para permitir as comparações de igualdade que find_if exige.
Método Vetor::InsertAt
Insere o item especificado no vetor atual no elemento identificado pelo índice especificado.
Sintaxe
virtual void InsertAt(unsigned int index, T item)
Parâmetros
índice
Um inteiro não assinado baseado em zero que especifica um elemento específico no objeto Vetor.
item
Um item para inserir no vetor no elemento especificado pelo índice. O tipo de item é definido pelo nome do tipo T .
Método Vetor::RemoveAt
Exclui o elemento identificado pelo índice especificado do vetor atual.
Sintaxe
virtual void RemoveAt(unsigned int index);
Parâmetros
índice
Um inteiro não assinado baseado em zero que especifica um elemento específico no objeto Vetor.
Método Vetor::RemoveAtEnd
Exclui o elemento no final do vetor atual.
Sintaxe
virtual void RemoveAtEnd();
Método Vetor::ReplaceAll
Exclui os elementos no vetor atual e, em seguida, 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 nome de tipo T .
Método Vetor::SetAt
Atribui o valor especificado ao elemento no vetor atual que é identificado pelo índice especificado.
Sintaxe
virtual void SetAt(unsigned int index, T item);
Parâmetros
índice
Um inteiro não assinado baseado em zero que especifica um elemento específico no objeto Vetor.
item
O valor a ser atribuído ao elemento especificado. O tipo de item é definido pelo nome do tipo T .
Método Vetor::Size
Retorna o número de elementos no objeto Vetor atual.
Sintaxe
virtual property unsigned int Size;
Valor de retorno
O número de elementos no vetor atual.
Vetor::Vetor Construtor
Inicializa uma nova instância da classe Vetor.
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
um
Um std::array que será usado para inicializar o vetor.
ARR
Um Platform::Array que será usado para inicializar o vetor.
InIt
O tipo de uma coleção de objetos que é usada para inicializar o vetor atual.
IL
Um std::initializer_list de objetos do tipo T que serão usados para inicializar o vetor.
N
O número de elementos em uma coleção de objetos que é usada para inicializar o vetor atual.
tamanho
O número de elementos no vetor.
value
Um valor que é usado para inicializar cada elemento no vetor atual.
v
Um Lvalues e Rvalues para um std::vetor que é usado para inicializar o vetor atual.
ptr
Ponteiro para um std::vector que é usado para inicializar o vetor atual.
first
O primeiro elemento em uma sequência de objetos que são usados para inicializar o vetor atual. O tipo de primeiro é passado por meio de encaminhamento perfeito. Para obter mais informações, consulte Rvalue Reference Declarator: &&.
last
O último elemento em uma sequência de objetos que são usados para inicializar o vetor atual. O tipo de último é passado por meio de encaminhamento perfeito. Para obter mais informações, consulte Rvalue Reference Declarator: &&.
Consulte também
Coleções (C++/CX)
Namespace da plataforma
Criando componentes do Tempo de Execução do Windows em C++