Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Observação
A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.
Suporta listas de CString objetos.
Sintaxe
class CStringList : public CObject
Membros
As funções membros de CStringList são semelhantes às funções membros da classe CObList. Devido a esta semelhança, pode usar a CObList documentação de referência para especificações da função dos membros. Sempre que vir um CObject ponteiro como valor de retorno, substitua por um CString (não por um CString apontador). Sempre que vê um CObject ponteiro como parâmetro de função, substitua-se por um LPCTSTR.
CObject*& CObList::GetHead() const;
por exemplo, traduz-se em
CString& CStringList::GetHead() const;
e ainda
POSITION AddHead( CObject* <newElement> );
traduz-se por
POSITION AddHead( LPCTSTR <newElement> );
Construtores Públicos
| Nome | Description |
|---|---|
CStringList::CStringList |
Constrói uma lista vazia. |
Métodos Públicos
| Nome | Description |
|---|---|
CStringList::AddHead |
Adiciona um elemento (ou todos os elementos de outra lista) ao cabeçalho da lista (cria um novo cabeça). |
CStringList::AddTail |
Adiciona um elemento (ou todos os elementos de outra lista) à cauda da lista (cria uma nova cauda). |
CStringList::Find |
Obtém a posição de um elemento especificada pelo valor do apontador. |
CStringList::FindIndex |
Obtém a posição de um elemento especificada por um índice baseado em zero. |
CStringList::GetAt |
Obtém o elemento numa dada posição. |
CStringList::GetCount |
Devolve o número de elementos nesta lista. |
CStringList::GetHead |
Devolve o elemento cabeça da lista (não pode estar vazio). |
CStringList::GetHeadPosition |
Devolve a posição do elemento principal da lista. |
CStringList::GetNext |
Recebe o próximo elemento para iterar. |
CStringList::GetPrev |
Recebe o elemento anterior para iterar. |
CStringList::GetSize |
Devolve o número de elementos nesta lista. |
CStringList::GetTail |
Devolve o elemento cauda da lista (não pode estar vazio). |
CStringList::GetTailPosition |
Devolve a posição do elemento de cauda da lista. |
CStringList::InsertAfter |
Insere um novo elemento após uma determinada posição. |
CStringList::InsertBefore |
Insere um novo elemento antes de uma dada posição. |
CStringList::IsEmpty |
Testa a condição de lista vazia (sem elementos). |
CStringList::RemoveAll |
Remove todos os elementos desta lista. |
CStringList::RemoveAt |
Remove um elemento desta lista, especificado pela posição. |
CStringList::RemoveHead |
Remove o elemento do topo da lista. |
CStringList::RemoveTail |
Remove o elemento da cauda da lista. |
CStringList::SetAt |
Coloca o elemento numa posição dada. |
Observações
Todas as comparações são feitas por valor, o que significa que os caracteres na cadeia são comparados em vez dos endereços das cadeias.
CStringList incorpora a IMPLEMENT_SERIAL macro para suportar a serialização e o despejo dos seus elementos. Se uma lista de CString objetos for armazenada num arquivo, seja com um operador de inserção sobrecarregado ou com a Serialize função membro, cada CString elemento é serializado por sua vez.
Se precisar de um dump de elementos individuais CString , deve definir a profundidade do contexto do dump para 1 ou superior.
Para mais informações sobre a utilização CStringListde , consulte o artigo Coleções.
Hierarquia de herança
CStringList
Requerimentos
Cabeçalho:afxcoll.h