lista (STL/CLR)

Artigo
02/25/2013

A classe de modelo descreve um objeto que controla uma seqüência de comprimento variando de elementos que tem acesso bidirecional.Use o contêiner list para gerenciar uma seqüência de elementos como uma lista vinculada de bidirecional de nós, cada um elemento de armazenamento.

Na descrição abaixo, GValue é o mesmo que Value , a menos que o último é um tipo de referência, caso em que é 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 seqüência controlada.

Membros

Definição de tipo	Descrição
List::const_iterator (STL/CLR)	O tipo de um iterador constante para a seqüência controlada.
List::const_reference (STL/CLR)	O tipo de uma referência constante a um elemento.
List::const_reverse_iterator (STL/CLR)	O tipo de um iterador inverso constante para a seqüê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 recipiente.
List::generic_iterator (STL/CLR)	O tipo de um iterador para a interface genérica para o recipiente.
List::generic_reverse_iterator (STL/CLR)	O tipo de um iterador inverso para a interface genérica para o recipiente.
List::generic_value (STL/CLR)	O tipo de um elemento da interface genérica para o recipiente.
List::Iterator (STL/CLR)	O tipo de um iterador para a seqüência controlada.
List::Reference (STL/CLR)	O tipo de uma referência a um elemento.
List::reverse_iterator (STL/CLR)	O tipo de um iterador inverso para a seqüê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 último elemento.
List::Begin (STL/CLR)	Designa o início da seqüência controlada.
List::Clear (STL/CLR)	Remove todos os elementos.
List::Empty (STL/CLR)	Testes se elementos não estão presentes.
List::end (STL/CLR)	Designa o final da seqüência controlada.
List::Erase (STL/CLR)	Remove os elementos em posições especificadas.
List::front (STL/CLR)	Acessa o primeiro elemento.
List::Insert (STL/CLR)	Adiciona elementos em uma posição especificada.
List::List (STL/CLR)	Constrói um objeto de recipiente.
List::Merge (STL/CLR)	Mescla dois ordenados seqüências controladas.
List::pop_back (STL/CLR)	Remove o último elemento.
List::pop_front (STL/CLR)	Remove o primeiro elemento.
List::push_back (STL/CLR)	Adiciona um novo elemento último.
List::push_front (STL/CLR)	Adiciona um novo elemento primeiro.
List::rbegin (STL/CLR)	Designa o início da seqüência controlada revertida.
List::Remove (STL/CLR)	Remove um elemento com um valor especificado.
List::remove_if (STL/CLR)	Remove os elementos que passar um teste especificada.
List::rend (STL/CLR)	Designa o final da seqüência controlada revertida.
List::Resize (STL/CLR)	Altera o número de elementos.
List::reverse (STL/CLR)	Inverte a seqüência controlada.
List::Size (STL/CLR)	Conta o número de elementos.
List::Sort (STL/CLR)	Ordena a seqüência controlada.
List::splice (STL/CLR)	Restitches links entre os nós.
List::swap (STL/CLR)	Troca o conteúdo dos dois recipientes.
List::to_array (STL/CLR)	Copia a seqüência controlada para uma nova matriz.
List::Unique (STL/CLR)	Remove elementos adjacentes que passar um teste especificada.

Propriedade	Descrição
List::back_item (STL/CLR)	Acessa o último elemento.
List::front_item (STL/CLR)	Acessa o primeiro elemento.

Operator	Descrição
List::Operator = (STL/CLR)	Substitui a seqüência controlada.
operador! = (STL/CLR) (lista)	Determina se um list não é igual a outro objeto list objeto.
operador < (lista) (STL/CLR)	Determina se um list objeto é menor que outro list objeto.
operador < = (STL/CLR) (lista)	Determina se um list objeto é menor ou igual a outro list objeto.
operador = = (STL/CLR) (lista)	Determina se um list objeto é igual a outro list objeto.
operador > (lista) (STL/CLR)	Determina se um list objeto é maior que o outro list objeto.
operador > = (STL/CLR) (lista)	Determina se um list objeto é maior ou igual a outro list objeto.

Interfaces

Interface	Descrição
ICloneable	Duplica um objeto.
IEnumerable	Por meio de elementos na seqüência.
ICollection	Manter o grupo de elementos.
IEnumerable<T>	Seqüência pelos elementos digitados.
ICollection<T>	Manter o grupo de elementos digitados.
IList <Value>	Manter um contêiner genérico.

Comentários

O objeto aloca e libera o armazenamento para a seqüência que ele controla como nós individuais em uma lista de link bidirecional.Ele reorganiza os elementos alterando os links entre os nós nunca copiando o conteúdo de um nó para outro.Isso significa que você pode inserir e remover elementos livremente sem atrapalhar elementos restantes.Assim, uma lista é um bom candidato para o contêiner subjacente para classe de modelo fila (STL/CLR) ou classe de modelo pilha (STL/CLR).

A list objeto oferece suporte a iteradores bidirecional, que significa passo dadas um iterador que designa um elemento na seqüência controlada de elementos adjacentes.Um nó principal especial corresponde ao iterador retornado por List::end (STL/CLR)().Você pode diminuir este iterador para alcançar o último elemento na seqüência controlada, se presente.Você pode incrementar um iterador de lista para alcançar o nó principal e, em seguida, comparar igual a end().Mas não cancelam o iterador retornado por end().

Observe que você não pode se referir a um elemento da lista diretamente dado sua posição numérica – o que requer um iterador de acesso aleatório.Portanto, é uma lista de not utilizável como contêiner subjacente de classe de modelo priority_queue (STL/CLR).

Um iterador lista armazena um identificador de nó lista associada, que por sua vez armazena um identificador de seu contêiner associado.Você pode usar iteradores somente com seus objetos de recipiente associado.Um iterador lista permanece válido desde que seu nó lista associada está associado a lista de alguns.Além disso, um iterador válido é dereferencable--ele pode ser usado para acessar ou alterar o valor do elemento designa – desde que não é igual a end().

Apagar ou remover um elemento chama o destruidor para o valor armazenado.Destruir o recipiente apaga todos os elementos.Assim, um recipiente cujo tipo de elemento é uma classe ref garante que nenhum elemento outlive no recipiente.Entretanto, observe que um recipiente de alças não not destruir seus elementos.