vector (STL/CLR)

Artigo
06/10/2015

A classe do modelo descreve um objeto que controla uma sequência de variar- comprimento dos elementos que tem de acesso aleatório. Você usa o contêiner vector para gerenciar uma sequência de elementos como um bloco contínuo de armazenamento. O bloco é implementado como uma matriz que cresça sob demanda.

Na descrição abaixo, GValue é o mesmo que Value a menos que o último é um tipo de referência, nesse caso é Value^.

template<typename Value>
    ref class vector
        :   public
        System::ICloneable,
        System::Collections::IEnumerable,
        System::Collections::ICollection,
        System::Collections::Generic::IEnumerable<GValue>,
        System::Collections::Generic::ICollection<GValue>,
        System::Collections::Generic::IList<GValue>,
        Microsoft::VisualC::StlClr::IVector<GValue>
    { ..... };

Parâmetros

Valor
O tipo de um elemento na sequência controlada.

Membros

Definição de tipo	Descrição
vector::const_iterator (STL/CLR)	O tipo de um iterador de constante para a sequência controlada.
vector::const_reference (STL/CLR)	O tipo de uma referência constante para um elemento.
vector::const_reverse_iterator (STL/CLR)	O tipo de um iterador invertido constante para a sequência controlada.
vector::difference_type (STL/CLR)	O tipo de uma distância assinada entre dois elementos.
vector::generic_container (STL/CLR)	O tipo de interface genérica para o contêiner.
vector::generic_iterator (STL/CLR)	O tipo de um iterador para a interface genérica para o contêiner.
vector::generic_reverse_iterator (STL/CLR)	O tipo de um iterador de cima para baixo para a interface genérica para o contêiner.
vector::generic_value (STL/CLR)	O tipo de um elemento para a interface genérica para o contêiner.
vector::iterator (STL/CLR)	O tipo de um iterador para a sequência controlada.
vector::reference (STL/CLR)	O tipo de uma referência para um elemento.
vector::reverse_iterator (STL/CLR)	O tipo de um iterador de cima para baixo para a sequência controlada.
vector::size_type (STL/CLR)	O tipo de uma distância assinada entre dois elementos.
vector::value_type (STL/CLR)	O tipo de um elemento.

Função de membro	Descrição
vector::assign (STL/CLR)	Substitui todos os elementos.
vector::at (STL/CLR)	Acessa um elemento em uma posição especificada.
vector::back (STL/CLR)	Acessa o elemento pela última vez.
vector::begin (STL/CLR)	Designa o início da sequência controlada.
vector::capacity (STL/CLR)	Informa o tamanho de armazenamento alocado para o contêiner.
vector::clear (STL/CLR)	Remove todos os elementos.
vector::empty (STL/CLR)	Testa se nenhum elemento estiver presente.
vector::end (STL/CLR)	Designa o término da sequência controlada.
vector::erase (STL/CLR)	Remove os elementos nas posições especificadas.
vector::front (STL/CLR)	Acessa o primeiro elemento.
vector::insert (STL/CLR)	Adiciona os elementos em uma posição especificada.
vector::pop_back (STL/CLR)	Remove o elemento pela última vez.
vector::push_back (STL/CLR)	Adiciona um novo elemento a última vez.
vector::rbegin (STL/CLR)	Designa o início da sequência controlada invertida.
vector::rend (STL/CLR)	Designa o término da sequência controlada invertida.
vector::reserve (STL/CLR)	Garante que uma capacidade mínima de crescimento do contêiner.
vector::resize (STL/CLR)	Altera o número de elementos.
vector::size (STL/CLR)	Conta o número de elementos.
vector::swap (STL/CLR)	Alterna o conteúdo de dois contêineres.
vector::to_array (STL/CLR)	Copia a sequência controlada a uma nova matriz.
vector::vector (STL/CLR)	Cria um objeto contêiner.

Propriedade	Descrição
vector::back_item (STL/CLR)	Acessa o elemento pela última vez.
vector::front_item (STL/CLR)	Acessa o primeiro elemento.

Operador	Descrição
vector::operator= (STL/CLR)	Substitui a sequência controlada.
vector::operator[] (STL/CLR)	Acessa um elemento em uma posição especificada.
operador!= (vector) (STL/CLR)	Determina se um objeto de vector não é igual a outro objeto de vector .
operador< (vector) (STL/CLR)	Determina se um objeto de vector é menor que outro objeto de vector .
operador<= (vector) (STL/CLR)	Determina se um objeto de vector é menor ou igual a outro objeto de vector .
operador== (vector) (STL/CLR)	Determina se um objeto de vector é igual a outro objeto de vector .
operador> (vector) (STL/CLR)	Determina se um objeto de vector é maior que outro objeto de vector .
operador>= (vector) (STL/CLR)	Determina se um objeto de vector é maior ou igual a outro objeto de vector .

Interfaces

Interface	Descrição
ICloneable	Duplica um objeto.
IEnumerable	Sequência por meio dos elementos.
ICollection	Mantenha o grupo de elementos.
IEnumerable	Sequência por meio dos elementos digitados.
ICollection	Mantenha o grupo de elementos de tipo.
IList	Manter ordenou o grupo de elementos de tipo.
IVectorValue<>	Mantenha o contêiner genérico.

Comentários

O objeto aloca e libera armazenamento para a sequência que controla armazenada com uma matriz de elementos de Value , que cresça sob demanda. O crescimento ocorre de forma que o custo de acrescentar um novo elemento são amortizados tempo constantes. Ou é o custo de adicionar elementos na extremidade não aumentam, em média, porque o comprimento da sequência controlada obtém maior. Assim, um vetor é uma boa candidata para o contêiner subjacente da classe stack (STL/CLR)do modelo.

vector oferece suporte aos iteradores de acesso aleatório, que significa você pode recorrer a um determinado elemento diretamente a posição numérica, contando de zero do primeiro elemento () para a frente, a vector::size (STL/CLR)() - 1 para o elemento () na última vez. Isso também significa que um vetor é uma boa candidata para o contêiner subjacente da classe priority_queue (STL/CLR)do modelo.

Um iterador de vetor armazena um identificador para o objeto associado de vetor, junto com a diferença que designa do elemento. Você pode usar iteradores apenas com seus objetos de contêiner associados. A diferença de um elemento de vetor é a mesma que sua posição.

Inserir ou apagar os elementos podem alterar o valor do elemento armazenado em uma posição especificada, assim o valor designado por um iterador também pode ser alterada. (O contêiner pode ter que copiar para cima ou para baixo nos elementos para criar um orifício antes de uma inserção ou para preencher um orifício depois de um erase.) Entretanto, um iterador de vetor permanece válido desde que a diferença está no intervalo [0, vector::size (STL/CLR)()]. Além disso, um iterador permanece válido dereferencable -- você pode usá-lo para acessar ou modificar o valor do elemento que designa -- desde que a tendência não é igual a size().

Apagando ou removendo um elemento chama o destruidor para seu valor armazenado. Destruir o contêiner apaga todos os elementos. Assim, um contêiner cujo tipo de elemento é uma classe de referência garante que nenhum elemento é maior que o contêiner. A observe, entretanto, que manipula um contêiner faz not destrói seus elementos.