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 |
---|---|
Constrói uma lista vazia para ponteiros de CObject . |
Métodos públicos
Nome |
Descrição |
---|---|
Adiciona elemento (ou todos os elementos em outros lista) no início da lista (faz um novo o início.) |
|
Adiciona elemento (ou todos os elementos em outros lista) ao final da lista (faz uma nova parte final). |
|
Obtém a posição de um elemento especificado pelo valor de ponteiro. |
|
Obtém a posição de um elemento especificado por um índice com base zero. |
|
Obtém o elemento em uma posição determinada. |
|
Retorna o número de elementos em esta lista. |
|
Retorna o elemento principal de lista (não pode ser deixado). |
|
Retorna a posição do elemento principal da lista. |
|
Obtém o próximo elemento para iterar. |
|
Obtém o elemento anterior para iterar. |
|
Retorna o número de elementos em esta lista. |
|
Retorna o elemento da parte final da lista (não pode ser deixado). |
|
Retorna a posição do elemento da parte final da lista. |
|
Insere um novo elemento após uma posição determinada. |
|
Insere um novo elemento antes que uma posição determinada. |
|
Testa a condição vazia de lista (elementos). |
|
Remove todos os elementos de esta lista. |
|
Remove um elemento de esta lista, por posição especificada. |
|
Remove o elemento do início da lista. |
|
Remove o elemento da parte final da lista. |
|
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
CObList
Requisitos
Cabeçalho: afxcoll.h