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
CStringList
Requisitos
Cabeçalho: afxcoll.h