Compartilhar via


Classe CStringList

Dá suporte a listas de objetos CString.

Sintaxe

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 semelhança, é possível usar a documentação de referência da CObList para obter a função específica de membro. Ao ver um ponteiro CObject como valor retornado, substitua um CString (não um ponteiro CString). Ao ver um ponteiro de CObject como um parâmetro de função, substitua um LPCTSTR.

CObject*& CObList::GetHead() const;

por exemplo, traduz para

CString& CStringList::GetHead() const;

e

POSITION AddHead( CObject* <newElement> );

traduz para

POSITION AddHead( LPCTSTR <newElement> );

Construtores públicos

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

Métodos públicos

Nome Descrição
CStringList::AddHead Adiciona um elemento (ou todos os elementos em outra lista) ao cabeçalho da lista (faz um novo cabeçalho).
CStringList::AddTail Adiciona um elemento (ou todos os elementos em outra lista) à parte final da lista (faz uma nova parte final).
CStringList::Find Obtém a posição de um elemento especificado pelo valor do ponteiro.
CStringList::FindIndex Obtém a posição de um elemento especificado por um índice baseado em zero.
CStringList::GetAt Obtém o elemento em uma determinada posição.
CStringList::GetCount Retorna o número de elementos nessa lista.
CStringList::GetHead Retorna o elemento head da lista (não pode estar vazio).
CStringList::GetHeadPosition Retorna a posição do elemento principal da lista.
CStringList::GetNext Obtém o próximo elemento para iteração.
CStringList::GetPrev Obtém o elemento anterior para iteração.
CStringList::GetSize Retorna o número de elementos nessa lista.
CStringList::GetTail Retorna o elemento final da lista (não pode estar vazio).
CStringList::GetTailPosition Retorna a posição do elemento final da lista.
CStringList::InsertAfter Insere um novo elemento após uma determinada posição.
CStringList::InsertBefore Insere um novo elemento antes de uma determinada posição.
CStringList::IsEmpty Testa a condição de lista vazia (sem elementos).
CStringList::RemoveAll Remove todos os elementos dessa lista.
CStringList::RemoveAt Remove um elemento dessa lista, especificado pela posição.
CStringList::RemoveHead Remove o elemento do cabeçalho da lista.
CStringList::RemoveTail Remove o elemento da parte final da lista.
CStringList::SetAt Define o elemento em uma determinada posição.

Comentários

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

A CStringList incorpora a macro IMPLEMENT_SERIAL para suportar serialização e despejo de seus elementos. Se uma lista de objetos CString for armazenada em um arquivo, com um operador de inserção sobrecarregado ou com a função membro Serialize, cada elemento CString será serializado por vez.

Se for necessário um despejo de elementos de individuais CString, será necessário definir a profundidade do contexto do despejo para 1 ou maior.

Para mais informações sobre como usar CStringList, confira o artigo Coleções.

Hierarquia de herança

CObject

CStringList

Requisitos

Cabeçalho: afxcoll.h

Confira também

Exemplo de MFC COLLECT
Classe CObject
Gráfico da hierarquia