Classe CStringList

Artigo
06/10/2015

Listas de suporte de objetos de CString .

class CStringList : public CObject

Membros

As funções de membro de CStringList são semelhantes às funções de membro da classe CObList. Devido a essa similaridade, você pode usar a documentação de referência de CObList para específicos da função de membro. Onde quer que você verá um ponteiro de CObject como um valor de retorno, substitua CString (não um ponteiro de CString ). Onde quer que você verá um ponteiro de CObject como um parâmetro de função, substitua LPCTSTR.

CObject*& CObList::GetHead() const;

por exemplo, converte a

CString& CStringList::GetHead() const;

POSITION AddHead( CObject* <newElement> );

converte a

POSITION AddHead( LPCTSTR <newElement> );

Construtores public

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

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

Todas as comparações são feitas por valor, o que significa que os caracteres na cadeia de caracteres são comparados em vez de endereços de cadeias de caracteres.

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

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

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

Hierarquia de herança

CObject

CStringList

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe CObject

Gráfico da hierarquia

Conceitos

O exemplo COLETA MFC

Compartilhar via