list (STL/CLR)

Artigo
06/10/2015

A classe do modelo descreve um objeto que controla uma sequência de variar- comprimento de elementos que tenha acesso bidirecional. Você usa o contêiner list para gerenciar uma sequência de elementos como uma lista vinculada bidirecional de nós, cada um elemento armazenando.

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 list
        :   public
        System::ICloneable,
        System::Collections::IEnumerable,
        System::Collections::ICollection,
        System::Collections::Generic::IEnumerable<GValue>,
        System::Collections::Generic::ICollection<GValue>,
        Microsoft::VisualC::StlClr::IList<GValue>
    { ..... };

Parâmetros

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

Membros

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

Função de membro	Descrição
list::assign (STL/CLR)	Substitui todos os elementos.
list::back (STL/CLR)	Acessa o elemento pela última vez.
list::begin (STL/CLR)	Designa o início da sequência controlada.
list::clear (STL/CLR)	Remove todos os elementos.
list::empty (STL/CLR)	Testa se nenhum elemento estiver presente.
list::end (STL/CLR)	Designa o término da sequência controlada.
list::erase (STL/CLR)	Remove os elementos nas posições especificadas.
list::front (STL/CLR)	Acessa o primeiro elemento.
list::insert (STL/CLR)	Adiciona os elementos em uma posição especificada.
list::list (STL/CLR)	Cria um objeto contêiner.
list::merge (STL/CLR)	Mescla duas sequências ordenadas controladas.
list::pop_back (STL/CLR)	Remove o elemento pela última vez.
list::pop_front (STL/CLR)	Remove o primeiro elemento.
list::push_back (STL/CLR)	Adiciona um novo elemento a última vez.
list::push_front (STL/CLR)	Adiciona um novo primeiro elemento.
list::rbegin (STL/CLR)	Designa o início da sequência controlada invertida.
list::remove (STL/CLR)	Remove um elemento com um valor especificado.
list::remove_if (STL/CLR)	Remove os elementos que passam um teste especificado.
list::rend (STL/CLR)	Designa o término da sequência controlada invertida.
list::resize (STL/CLR)	Altera o número de elementos.
list::reverse (STL/CLR)	Inverte a sequência controlada.
list::size (STL/CLR)	Conta o número de elementos.
list::sort (STL/CLR)	Classifica a sequência controlada.
list::splice (STL/CLR)	Links de Restitches entre nós.
list::swap (STL/CLR)	Alterna o conteúdo de dois contêineres.
list::to_array (STL/CLR)	Copia a sequência controlada a uma nova matriz.
list::unique (STL/CLR)	Remove os elementos adjacentes que passam um teste especificado.

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

Operador	Descrição
list::operator= (STL/CLR)	Substitui a sequência controlada.
operador!= (list) (STL/CLR)	Determina se um objeto de list não é igual a outro objeto de list .
operador< (list) (STL/CLR)	Determina se um objeto de list é menor que outro objeto de list .
operador<= (list) (STL/CLR)	Determina se um objeto de list é menor ou igual a outro objeto de list .
operador== (list) (STL/CLR)	Determina se um objeto de list é igual a outro objeto de list .
operador> (list) (STL/CLR)	Determina se um objeto de list é maior que outro objeto de list .
operador>= (list) (STL/CLR)	Determina se um objeto de list é maior ou igual a outro objeto de list .

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.
IListValue<>	Mantenha o contêiner genérico.

Comentários

O objeto aloca e libera armazenamento para a sequência que controla como os nós individuais em um link bidirecional lista. Reorganiza os elementos alterando os links entre nós, nunca copiar o conteúdo de um nó para outro. Isso significa que você pode inserir e remover os elementos livremente sem os outros elementos de perturbação. Portanto, uma lista é uma boa candidata para o contêiner subjacente da classe queue (STL/CLR) do modelo ou a classe stack (STL/CLR)do modelo.

Um objeto de list oferece suporte aos iteradores bidirecionais, o que significa que você pode avançar para os elementos adjacentes um iterador dados que designa um elemento na sequência controlada. Um nó principal especial corresponde ao iterador retornado por list::end (STL/CLR)(). Você pode diminuir este iterador para alcançar o elemento o mais recente na sequência controlada, se houver. É possível incrementar um iterador da lista para alcançar o nó principal, e comparará no igual a end(). Mas você não pode desreferenciar o iterador retornado por end().

Observe que você não pode se referir a um elemento da lista determinado diretamente a posição numérica -- isso requer um iterador de acesso aleatório. Para uma lista é útil not como o contêiner subjacente da classe priority_queue (STL/CLR)do modelo.

Um iterador da lista armazena um identificador para o nó associado na lista, por sua vez que armazena um identificador para o contêiner associado. Você pode usar iteradores apenas com seus objetos de contêiner associados. Um iterador da lista permanece válido desde que o nó associado na lista é associado a qualquer lista. Além disso, um iterador válido é dereferencable -- você pode usá-lo para acessar ou modificar o valor do elemento que designa -- contanto que não é igual a end().

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.