Compartilhar via


Classe Platform::Collections::VectorView

Representa uma exibição somente leitura de uma coleção sequencial de objetos que podem ser acessados separadamente por índice. O tipo de cada objeto na coleção é especificado pelo parâmetro de modelo.

Sintaxe

template <typename T, typename E>
   ref class VectorView sealed;

Parâmetros

T
O tipo dos elementos contidos no objeto VectorView .

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

A classe VectorView implementa a interface Windows::Foundation::Collections::IVectorView<T> e o suporte para iteradores da Biblioteca de Modelos Padrão.

Membros

Construtores públicos

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

Métodos públicos

Nome Descrição
VectorView::First Retorna um iterador que especifica o primeiro elemento em VectorView.
VectorView::GetAt Recupera o elemento de VectorView atual que é indicado pelo índice especificado.
VectorView::GetMany Recupera uma sequência de itens de VectorView atual, começando no índice especificado.
VectorView::IndexOf Procura o item especificado no VectorView atual e, se encontrado, retorna o índice do item.
VectorView::Tamanho Retorna o número de elementos no objeto VectorView atual.

Hierarquia de herança

VectorView

Requisitos

Cabeçalho: collection.h

Namespace: Platform::Collections

Método VectorView::First

Retorna um iterador que especifica o primeiro elemento em VectorView.

Sintaxe

virtual Windows::Foundation::Collections::IIterator<T>^
   First();

Valor retornado

Um iterador que especifica o primeiro elemento em VectorView.

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 = myVectorView->First();.

Método VectorView::GetAt

Recupera o elemento de VectorView atual que é indicado pelo índice especificado.

Sintaxe

T GetAt(
   UInt32 index
);

Parâmetros

index
Um inteiro sem sinal de base zero que especifica um determinado elemento no objeto VectorView.

Valor de retorno

O elemento especificado pelo parâmetro index. O tipo de elemento é especificado pelo parâmetro de modelo VectorView, T.

Método VectorView::GetMany

Recupera uma sequência de itens de VectorView atual, começando no índice especificado.

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
Quando essa operação for concluída, uma matriz de itens que começam com o elemento especificado por startIndex e que terminam no último elemento no VectorView.

Valor de retorno

O número de itens recuperados.

Método VectorView::IndexOf

Procura o item especificado no VectorView 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 VectorView ou se 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.

Método VectorView::Size

Retorna o número de elementos no objeto VectorView atual.

Sintaxe

virtual property unsigned int Size;

Valor retornado

O número de elementos no VectorView atual.

Construtor VectorView::VectorView

Inicializa uma nova instância da classe VectorView.

Sintaxe

VectorView();
explicit VectorView(
   UInt32 size
);
VectorView(
   UInt32 size,
   T value
);
explicit VectorView(
   const ::std::vector<T>& v
);
explicit VectorView(
   ::std::vector<T>&& v
);
VectorView(
   const T * ptr,
   UInt32 size
);

template <
   size_t N
>
explicit VectorView(
   const T (&arr)[N]
);

template <
   size_t N
>
explicit VectorView(
   const ::std::array<T,
   N>& a
);

explicit VectorView(
   const ::Platform::Array<T>^ arr
);

template <
   typename InIt
>
VectorView(
   InItfirst,
   InItlast
);

VectorView(
   std::initializer_list<T> il
);

Parâmetros

InIt
O tipo de uma coleção de objetos que é usada para inicializar o VectorView atual.

il
Uma std::initializer_list cujos elementos serão usados para inicializar o VectorView.

N
O número de elementos em uma coleção de objetos que é usada para inicializar o VectorView atual.

size
O número de elementos no VectorView.

value
Um valor que é usado para inicializar cada elemento no VectorView atual.

v
Um Lvalues e Rvalues para um ::std::vector que é usado para inicializar o VectorView atual.

ptr
Ponteiro para um std::vector que é usado para inicializar o VectorView atual.

arr
Um objeto Platform::Array que é usado para inicializar o VectorView atual.

a
Um objeto std::array que é usado para inicializar o VectorView atual.

first
O primeiro elemento em uma sequência de objetos que é usado para inicializar o VectorView 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 VectorView 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

Namespace de Plataforma
Criando componentes do Windows Runtime no C++