Acessar todos os membros de uma coleção

Artigo
08/25/2010

As classes de coleção MFC array — ambos baseado em modelo e não — usam índices para acesso seus elementos.As classes de coleção de lista e MAP MFC — ambos baseado em modelo e não — usar um indicador do tipo POSIÇÃO para descrever uma determinada posição dentro da coleção.Para acessar um ou mais membros dessas coleções, você primeiro inicializar o indicador de posição e, em seguida, várias vezes passa essa posição para a coleção e pedir para retornar o próximo elemento.A coleção não é responsável por manter as informações de estado sobre o progresso da iteração.Que informações são mantidas no indicador de posição.Mas, dada uma determinada posição, a coleção é responsável por retornar o próximo elemento.

Os procedimentos a seguir mostram como iterar sobre os três principais tipos de coleções fornecidos com o MFC:

Uma matriz de iteração
Uma lista de iteração
Iterando um MAP

Para iterar um array

Use números seqüenciais de índice com o GetAt função de membro:
```
CTypedPtrArray<CObArray, CPerson*> myArray;

myArray.Add(new CPerson());
for (int i = 0; i < myArray.GetSize();i++)
{
   CPerson* thePerson = myArray.GetAt(i);
   thePerson->AssertValid();
}       
```
Este exemplo usa uma matriz de ponteiro digitado contém ponteiros para CPerson objetos. A matriz é derivada da classe CObArrayuma das classes nontemplate predefinido. GetAt Retorna um ponteiro para um CPerson objeto. Para classes de coleção de tipos ponteiro — arrays ou listas — o primeiro parâmetro especifica a classe base; o segundo parâmetro especifica o tipo de armazenamento.

The CTypedPtrArray class also overloads the [ ] operator so that you can use the customary array-subscript syntax to access elements of an array.Uma alternativa para a demonstrativo no corpo do for loop acima é
```
CPerson* thePerson = myArray[i];
```
Este operador existe em ambas as Const and non-Const versões.The Const versão, que é invocado para Const arrays, podem aparecer somente na lado direito da demonstrativo de atribuição.

Para iterar uma lista

Use as funções de membro GetHeadPosition e GetNext para trabalhar sua maneira através da lista:
```
CTypedPtrList<CObList, CPerson*> myList;

myList.AddHead(new CPerson());
POSITION pos = myList.GetHeadPosition();
while(pos != NULL)
{
   CPerson* thePerson = myList.GetNext(pos);
   thePerson->AssertValid();
}
```
Este exemplo usa uma lista de tipos ponteiro para contêm ponteiros para CPerson objetos. A declaração da lista semelhante da matriz no procedimento Para iterar um array , mas é derivado da classe CObList. GetNext Retorna um ponteiro para um CPerson objeto.

Para iterar um MAP

Use GetStartPosition para ir para o início do MAP e GetNextAssoc para várias vezes obter a próxima chave e valor do MAP, conforme mostrado pelo seguinte exemplo:

CMap<CString, LPCTSTR, CPerson*, CPerson*> myMap;
CPerson myPerson;

myMap.SetAt(_T("Bill"), &myPerson);
POSITION pos = myMap.GetStartPosition();
while(pos != NULL)
{
   CPerson* pPerson;
   CString string;
   // Get key (string) and value (pPerson)
   myMap.GetNextAssoc(pos, string, pPerson);
   // Use string and pPerson
}

Este exemplo usa um modelo de MAP simples (em vez de uma coleção de tipos ponteiro) que usa a CString chaves e armazenamentos de ponteiros para CPerson objetos. Ao usar funções de acesso, sistema autônomo GetNextAssoc, a classe fornece ponteiros para CPerson objetos. Se você usar uma das coleções nontemplate MAP em vez disso, você deve converter o retornado CObject ponteiro para um ponteiro para um CPerson.

Observação:
Para nontemplate mapas, o compilador requer uma referência a um CObject ponteiro no último parâmetro para GetNextAssoc. Na entrada, você deve converter sistema autônomo ponteiros para esse tipo, conforme mostrado no exemplo seguinte.

A solução de modelo é mais simples e ajuda a fornecer melhor segurança de tipos.O código nontemplate é mais complicado, sistema autônomo você pode ver aqui:

CMapStringToOb myMap;    // A nontemplate collection class
CPerson myPerson;
myMap.SetAt(_T("Bill"), &myPerson);

POSITION pos = myMap.GetStartPosition();
while(pos != NULL)
{
   CPerson* pPerson;
   CString string;
   // Gets key (string) and value (pPerson)
   myMap.GetNextAssoc(pos, string, 
                     (CObject*&)pPerson);
   ASSERT(pPerson->IsKindOf(
             RUNTIME_CLASS(CPerson)));
   // Use string and pPerson
}

Para obter mais informações, consulte Excluir todos os objetos em uma coleção CObject.

Consulte também

Conceitos

Coleções

Compartilhar via