Compartilhar via


Classe cObList

O oferece suporte ordenaram listas de ponteiros nonunique de CObject acessíveis em seqüência ou pelo valor de ponteiro.

class CObList : public CObject

Membros

Construtores public

Nome

Descrição

CObList::CObList

Constrói uma lista vazia para ponteiros de CObject .

Métodos públicos

Nome

Descrição

CObList::AddHead

Adiciona elemento (ou todos os elementos em outros lista) no início da lista (faz um novo o início.)

CObList::AddTail

Adiciona elemento (ou todos os elementos em outros lista) ao final da lista (faz uma nova parte final).

CObList::Find

Obtém a posição de um elemento especificado pelo valor de ponteiro.

CObList::FindIndex

Obtém a posição de um elemento especificado por um índice com base zero.

CObList::GetAt

Obtém o elemento em uma posição determinada.

CObList::GetCount

Retorna o número de elementos em esta lista.

CObList::GetHead

Retorna o elemento principal de lista (não pode ser deixado).

CObList::GetHeadPosition

Retorna a posição do elemento principal da lista.

CObList::GetNext

Obtém o próximo elemento para iterar.

CObList::GetPrev

Obtém o elemento anterior para iterar.

CObList::GetSize

Retorna o número de elementos em esta lista.

CObList::GetTail

Retorna o elemento da parte final da lista (não pode ser deixado).

CObList::GetTailPosition

Retorna a posição do elemento da parte final da lista.

CObList::InsertAfter

Insere um novo elemento após uma posição determinada.

CObList::InsertBefore

Insere um novo elemento antes que uma posição determinada.

CObList::IsEmpty

Testa a condição vazia de lista (elementos).

CObList::RemoveAll

Remove todos os elementos de esta lista.

CObList::RemoveAt

Remove um elemento de esta lista, por posição especificada.

CObList::RemoveHead

Remove o elemento do início da lista.

CObList::RemoveTail

Remove o elemento da parte final da lista.

CObList::SetAt

Define o elemento em uma posição determinada.

Comentários

As listas deCObList 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.

CObList inserir a macro de IMPLEMENT_SERIAL para oferecer suporte a serialização e a despejo de seus elementos. Se uma lista de ponteiros de CObject é armazenada em um arquivo, com um operador sobrecarregado insert ou com a função de membro de Serialize , cada elemento de CObject é serializado por sua vez.

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

Quando um objeto de CObList é excluído, ou quando seus elementos são removidos, somente os ponteiros de CObject são removidos, não os objetos que referenciam.

Você pode derivar suas próprias classes de CObList. A nova classe de lista, projetada para armazenar ponteiros para objetos derivados de CObject, adicionar novos membros de dados e novas funções de membro. Observe que a lista resultante não é estritamente com segurança de tipos, pois ele permite a inserção de todo o ponteiro de CObject .

Dica

Você deve usar a macro de IMPLEMENT_SERIAL na implementação da classe derivada se você pretende serializar a lista.

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

Hierarquia de herança

CObject

CObList

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe CObject

Gráfico da hierarquia

Classe CStringList

Classe CPtrList