Classe Platform::Collections::VectorPlatform::Collections::Vector Class

Representa uma coleção sequencial de objetos que podem ser acessados separadamente por índice.Represents a sequential collection of objects that can be individually accessed by index. Implementa Windows:: Foundation:: Collections:: IObservableVector para ajudar com a vinculação de dadosXAML.Implements Windows::Foundation::Collections::IObservableVector to help with XAML data binding.

SintaxeSyntax

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

parâmetrosParameters

TT
O tipo dos elementos contidos no objeto Vector.The type of the elements contained in the Vector object.

OrientalE
Especifica um predicado binário para testar a igualdade com valores do tipo T. O valor padrão é std::equal_to<T> .Specifies a binary predicate for testing equality with values of type T. The default value is std::equal_to<T>.

ComentáriosRemarks

Os tipos permitidos são:Allowed types are:

  1. integersintegers

  2. classe de interface ^interface class^

  3. classe ref pública^public ref class^

  4. estrutura de valorvalue struct

  5. classe de enum públicapublic enum class

A classe vector é a implementação concreta do C++ da interface Windows:: Foundation:: Collections:: IVector .The Vector class is the C++ concrete implementation of the Windows::Foundation::Collections::IVector interface.

Se você tentar usar um tipo de vetor em um valor de retorno público ou parâmetro, o erro do compilador C3986 será gerado.If you attempt to use a Vector type in a public return value or parameter, compiler error C3986 is raised. Você pode corrigir o erro alterando o tipo do parâmetro ou do valor de retorno para Windows::Foundation::Collections::IVector.You can fix the error by changing the parameter or return value type to Windows::Foundation::Collections::IVector. Para obter mais informações, consulte Coleções (C++/CX).For more information, see Collections (C++/CX).

MembrosMembers

Construtores públicosPublic Constructors

NomeName DescriçãoDescription
Vetor:: vectorVector::Vector Inicializa uma nova instância da classe Vector.Initializes a new instance of the Vector class.

Métodos públicosPublic Methods

NomeName DescriçãoDescription
Vector::AppendVector::Append Insere o item especificado após o último item no Vector atual.Inserts the specified item after the last item in the current Vector.
Vetor:: ClearVector::Clear Exclui todos os elementos no Vector atual.Deletes all the elements in the current Vector.
Vetor:: primeiroVector::First Retorna um iterador que especifica o primeiro elemento em Vector.Returns an iterator that specifies the first element in the Vector.
Vetor:: GetAtVector::GetAt Recupera o elemento de Vector atual que é identificado pelo índice especificado.Retrieves the element of the current Vector that is identifed by the specified index.
Vetor:: getmanyVector::GetMany Recupera uma sequência de itens de Vector atual, começando no índice especificado.Retrieves a sequence of items from the current Vector, starting at the specified index.
Vetor:: GetViewVector::GetView Retorna uma exibição somente leitura de um Vector; isto é, um Platform::Collections::VectorView.Returns a read-only view of a Vector; that is, a Platform::Collections::VectorView.
Vector:: IndexOfVector::IndexOf Procura o item especificado no vetor atual, e se encontrado, retorna o índice do item.Searches for the specified item in the current Vector, and if found, returns the index of the item.
Vector::InsertAtVector::InsertAt Insere o item especificado no vetor atual no elemento identificado pelo índice especificado.Inserts the specified item into the current Vector at the element identified by the specified index.
Vector::ReplaceAllVector::ReplaceAll Exclui os elementos no Vector atual e insere os elementos da matriz especificada.Deletes the elements in the current Vector and then inserts the elements from the specified array.
Vector::RemoveAtVector::RemoveAt Exclui o elemento identificado pelo índice especificado do Vector atual.Deletes the element identified by the specified index from the current Vector.
Vector::RemoveAtEndVector::RemoveAtEnd Exclui o elemento no final do Vector atual.Deletes the element at the end of the current Vector.
Vector::SetAtVector::SetAt Atribui o valor especificado ao elemento no Vector atual que é identificado pelo índice especificado.Assigns the specified value to the element in the current Vector that is identified by the specified index.
Vetor:: SizeVector::Size Retorna o número de elementos no objeto Vector atual.Returns the number of elements in the current Vector object.

EventosEvents

NomeName DescriçãoDescription
evento Windows:: Foundation:: Collection:: VectorChangedEventHandler <T> ^ vectorchangedevent Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged Ocorre quando o Vector é alterado.Occurs when the Vector changes.

Hierarquia de herançaInheritance Hierarchy

Vector

RequisitosRequirements

Cabeçalho: collection.hHeader: collection.h

Namespace: Platform::CollectionsNamespace: Platform::Collections

Método Vector:: AppendVector::Append Method

Insere o item especificado após o último item no Vector atual.Inserts the specified item after the last item in the current Vector.

SintaxeSyntax

virtual void Append(T item);

parâmetrosParameters

indexindex
O item a ser inserido no Vector.The item to insert into the Vector. O tipo de Item é definido pelo TypeName de T .The type of item is defined by the T typename.

Método Vector:: ClearVector::Clear Method

Exclui todos os elementos no Vector atual.Deletes all the elements in the current Vector.

SintaxeSyntax

virtual void Clear();

Método Vector:: FirstVector::First Method

Retorna um iterador que aponta para o primeiro elemento em Vector.Returns an iterator that points to the first element in the Vector.

SintaxeSyntax

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

Valor retornadoReturn Value

Um iterador que aponta para o primeiro elemento em Vector.An iterator that points to the first element in the Vector.

ComentáriosRemarks

Uma maneira conveniente de manter o iterador retornado pelo primeiro () é atribuir o valor de retorno a uma variável que é declarada com a auto palavra-chave de dedução de tipo.A convenient way to hold the iterator returned by First() is to assign the return value to a variable that is declared with the auto type deduction keyword. Por exemplo, auto x = myVector->First();.For example, auto x = myVector->First();. Este iterador conhece a duração da coleta.This iterator knows the length of the collection.

Quando você precisar de um par de iteradores para passar para uma função STL, use as funções gratuitas Windows:: Foundation:: coleções:: Begin e Windows:: Foundation:: Collections:: EndWhen you need a pair of iterators to pass to an STL function, use the free functions Windows::Foundation::Collections::begin and Windows::Foundation::Collections::end

Método Vector:: GetAtVector::GetAt Method

Recupera o elemento de Vector atual que é identificado pelo índice especificado.Retrieves the element of the current Vector that is identifed by the specified index.

SintaxeSyntax

virtual T GetAt(unsigned int index);

parâmetrosParameters

indexindex
Um inteiro não assinado com base zero que especifica um determinado elemento no objeto Vector.A zero-based, unsigned integer that specifies a particular element in the Vector object.

Valor RetornadoReturn Value

O elemento especificado pelo parâmetro de índice .The element specified by the index parameter. O tipo de elemento é definido pelo TypeName de T .The element type is defined by the T typename.

Método Vector:: getmanyVector::GetMany Method

Recupera uma sequência de itens de Vector atual, começando a partir do índice especificado e os copia na matriz alocada pelo chamador.Retrieves a sequence of items from the current Vector, starting at the specified index, and copies them into the caller-allocated array.

SintaxeSyntax

virtual unsigned int GetMany(
    unsigned int startIndex,
    Platform::WriteOnlyArray<T>^ dest);

parâmetrosParameters

startIndexstartIndex
O índice com base zero do início dos itens a serem recuperados.The zero-based index of the start of the items to retrieve.

destdest
Uma matriz de itens alocada pelo chamador que começa no elemento especificado por startIndex e termina no último elemento no vetor.A caller-allocated array of items that begin at the element specified by startIndex and end at the last element in the Vector.

Valor RetornadoReturn Value

O número de itens recuperados.The number of items retrieved.

ComentáriosRemarks

Esta função não se destina a ser usada diretamente pelo código do cliente.This function is not intended for use directly by client code. Ele é usado internamente na função to_vector para permitir a conversão eficiente de instâncias de plataforma:: vector para instâncias std:: vector.It is used internally in the to_vector Function to enable efficient conversion of Platform::Vector intances to std::vector instances.

Método Vector:: GetViewVector::GetView Method

Retorna uma exibição somente leitura de um Vector; isto é, um IVectorView.Returns a read-only view of a Vector; that is, an IVectorView.

SintaxeSyntax

Windows::Foundation::Collections::IVectorView<T>^ GetView();

Valor retornadoReturn Value

Um objeto IVectorView.An IVectorView object.

Método Vector:: IndexOfVector::IndexOf Method

Procura o item especificado no vetor atual, e se encontrado, retorna o índice do item.Searches for the specified item in the current Vector, and if found, returns the index of the item.

SintaxeSyntax

virtual bool IndexOf(T value, unsigned int* index);

parâmetrosParameters

valuevalue
O item a ser localizado.The item to find.

indexindex
O índice de base zero do item se o valor do parâmetro for encontrado; caso contrário, 0.The zero-based index of the item if parameter value is found; otherwise, 0.

O parâmetro de índice será 0 se o item for o primeiro elemento do vetor ou o item não for encontrado.The index parameter is 0 if either the item is the first element of the Vector or the item was not found. Se o valor de retorno for true , o item foi encontrado e será o primeiro elemento; caso contrário, o item não foi encontrado.If the return value is true, the item was found and it is the first element; otherwise, the item was not found.

Valor RetornadoReturn Value

true Se o item especificado for encontrado; caso contrário, false .true if the specified item is found; otherwise, false.

ComentáriosRemarks

O IndexOf usa o std::find_if para encontrar o item.IndexOf uses std::find_if to find the item. Tipos de elementos personalizados deverão, portanto, sobrecarregar os operadores == e != para habilitar as comparações de igualdade exigidas por find_if.Custom element types should therefore overload the == and != operator in order to enable the equality comparisons that find_if requires.

Método Vector:: InsertAtVector::InsertAt Method

Insere o item especificado no vetor atual no elemento identificado pelo índice especificado.Inserts the specified item into the current Vector at the element identified by the specified index.

SintaxeSyntax

virtual void InsertAt(unsigned int index, T item)

parâmetrosParameters

indexindex
Um inteiro não assinado com base zero que especifica um determinado elemento no objeto Vector.A zero-based, unsigned integer that specifies a particular element in the Vector object.

itemitem
Um item a ser inserido no vetor no elemento especificado pelo índice.An item to insert into the Vector at the element specified by index. O tipo de Item é definido pelo TypeName de T .The type of item is defined by the T typename.

Método Vector:: RemoveAtVector::RemoveAt Method

Exclui o elemento identificado pelo índice especificado do Vector atual.Deletes the element identified by the specified index from the current Vector.

SintaxeSyntax

virtual void RemoveAt(unsigned int index);

parâmetrosParameters

indexindex
Um inteiro não assinado com base zero que especifica um determinado elemento no objeto Vector.A zero-based, unsigned integer that specifies a particular element in the Vector object.

Método Vector:: RemoveAtEndVector::RemoveAtEnd Method

Exclui o elemento no final do Vector atual.Deletes the element at the end of the current Vector.

SintaxeSyntax

virtual void RemoveAtEnd();

Método Vector:: ReplaceAllVector::ReplaceAll Method

Exclui os elementos no Vector atual e insere os elementos da matriz especificada.Deletes the elements in the current Vector and then inserts the elements from the specified array.

SintaxeSyntax

virtual void ReplaceAll(const ::Platform::Array<T>^ arr);

parâmetrosParameters

arrarr
Uma matriz de objetos cujo tipo é definido pelo TypeName de T .An array of objects whose type is defined by the T typename.

Método Vector:: SetAtVector::SetAt Method

Atribui o valor especificado ao elemento no Vector atual que é identificado pelo índice especificado.Assigns the specified value to the element in the current Vector that is identified by the specified index.

SintaxeSyntax

virtual void SetAt(unsigned int index, T item);

parâmetrosParameters

indexindex
Um inteiro não assinado com base zero que especifica um determinado elemento no objeto Vector.A zero-based, unsigned integer that specifies a particular element in the Vector object.

itemitem
O valor a ser atribuído ao elemento especificado.The value to assign to the specified element. O tipo de Item é definido pelo TypeName de T .The type of item is defined by the T typename.

Método Vector:: SizeVector::Size Method

Retorna o número de elementos no objeto Vector atual.Returns the number of elements in the current Vector object.

SintaxeSyntax

virtual property unsigned int Size;

Valor retornadoReturn Value

O número de elementos no Vector atual.The number of elements in the current Vector.

Construtor vector:: vectorVector::Vector Constructor

Inicializa uma nova instância da classe Vector.Initializes a new instance of the Vector class.

SintaxeSyntax

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âmetrosParameters

uma
Um std:: array que será usado para inicializar o vetor.A std::array that will be used to initialize the Vector.

arrarr
Uma plataforma:: matriz que será usada para inicializar o vetor.A Platform::Array that will be used to initialize the Vector.

IniciarInIt
O tipo de uma coleção de objetos que é usada para inicializar o Vector atual.The type of a collection of objects that is used to initialize the current Vector.

Ilil
Um std:: initializer_list de objetos do tipo T que será usado para inicializar o vetor.A std::initializer_list of objects of type T that will be used to initialize the Vector.

NN
O número de elementos em uma coleção de objetos que é usada para inicializar o Vector atual.The number of elements in a collection of objects that is used to initialize the current Vector.

sizesize
O número de elementos no Vector.The number of elements in the Vector.

valuevalue
Um valor que é usado para inicializar cada elemento no Vector atual.A value that is used to initialize each element in the current Vector.

lv
Um lvalue e um rvalues para um std:: vector que é usado para inicializar o vetor atual.An Lvalues and Rvalues to a std::vector that is used to initialize the current Vector.

ptrptr
Ponteiro para um std::vector que é usado para inicializar o Vector atual.Pointer to a std::vector that is used to initialize the current Vector.

firstfirst
O primeiro elemento em uma sequência de objetos que é usado para inicializar o Vector atual.The first element in a sequence of objects that are used to initialize the current Vector. O tipo de primeiro é passado por meio de encaminhamento perfeito.The type of first is passed by means of perfect forwarding. Para obter mais informações, consulte Declarador de referência Rvalue: &&.For more information, see Rvalue Reference Declarator: &&.

lastlast
O último elemento em uma sequência de objetos que é usado para inicializar o Vector atual.The last element in a sequence of objects that are used to initialize the current Vector. O tipo de último é passado por meio de encaminhamento perfeito.The type of last is passed by means of perfect forwarding. Para obter mais informações, consulte Declarador de referência Rvalue: &&.For more information, see Rvalue Reference Declarator: &&.

Confira tambémSee also

Coleções (C++/CX)Collections (C++/CX)
Namespace da plataformaPlatform Namespace
Criando componentes do Windows Runtime no C++Creating Windows Runtime Components in C++