Classe de CList

Artigo
03/26/2013

O oferece suporte ordenaram lista de objetos nonunique acessíveis em seqüência ou por valor.

template< class TYPE, class ARG_TYPE = const TYPE& > 
class CList : public CObject

Membros

Construtores public

Nome	Descrição
CList::CList	Constrói uma lista ordenada vazia.

Métodos públicos

Nome	Descrição
CList::AddHead	Adiciona elemento (ou todos os elementos em outros lista) no início da lista (faz um novo o início.)
CList::AddTail	Adiciona elemento (ou todos os elementos em outros lista) ao final da lista (faz uma nova parte final).
CList::Find	Obtém a posição de um elemento especificado pelo valor de ponteiro.
CList::FindIndex	Obtém a posição de um elemento especificado por um índice com base zero.
CList::GetAt	Obtém o elemento em uma posição determinada.
CList::GetCount	Retorna o número de elementos em esta lista.
CList::GetHead	Retorna o elemento principal de lista (não pode ser deixado).
CList::GetHeadPosition	Retorna a posição do elemento principal da lista.
CList::GetNext	Obtém o próximo elemento para iterar.
CList::GetPrev	Obtém o elemento anterior para iterar.
CList::GetSize	Retorna o número de elementos em esta lista.
CList::GetTail	Retorna o elemento da parte final da lista (não pode ser deixado).
CList::GetTailPosition	Retorna a posição do elemento da parte final da lista.
CList::InsertAfter	Insere um novo elemento após uma posição determinada.
CList::InsertBefore	Insere um novo elemento antes que uma posição determinada.
CList::IsEmpty	Testa a condição vazia de lista (elementos).
CList::RemoveAll	Remove todos os elementos de esta lista.
CList::RemoveAt	Remove um elemento de esta lista, por posição especificada.
CList::RemoveHead	Remove o elemento do início da lista.
CList::RemoveTail	Remove o elemento da parte final da lista.
CList::SetAt	Define o elemento em uma posição determinada.

Parâmetros

TYPE
Tipo de objeto armazenado na lista.
ARG*_*TYPE
Tipo usado para referenciar os objetos armazenados na lista.Pode ser uma referência.

Comentários

As listas deCList se comportam como listas vinculadas de.

Uma variável do tipo POSIÇÃO é uma chave para a lista.Você pode usar uma variável de POSIÇÃO como um iterador para atravessar seqüencialmente uma lista e como um indicador para armazenar um local.Uma posição não é a mesma que um índice, mas.

Inserção do elemento é muito rápido no início da lista, na parte final, e em POSIÇÃOconhecido.Uma busca seqüencial é necessária para analisar um elemento por valor ou pelo índice.Esta pesquisa pode ser lento se a lista é longa.

Se você precisar de um despejo dos elementos individuais na lista, você deve definir o tamanho do contexto de um despejo a 1 ou maior.

Determinadas funções de membro de essa classe chamam funções auxiliares globais que devem ser personalizadas para a maioria dos usos da classe de CList .Consulte Auxiliares de classe de coleção da seção “macros.” e de Globais

Para obter mais informações sobre como usar CList, consulte o artigo coleções.

Exemplo

// CList is a template class that takes two template arguments.
// The first argument is type stored internally by the list, the
// second argument is the type used in the arguments for the
// CList methods.

// This code defines a list of ints.
CList<int,int> myIntList;

// This code defines a list of CStrings
CList<CString,CString&> myStringList;

// This code defines a list of MYTYPEs,
// NOTE: MYTYPE could be any struct, class or type definition
CList<MYTYPE,MYTYPE&> myTypeList;