Uzyskiwanie dostępu do wszystkich elementów członkowskich kolekcji

Klasy kolekcji tablic MFC — zarówno oparte na szablonach, jak i nie — używają indeksów w celu uzyskania dostępu do ich elementów. Klasy listy MFC i kolekcji map — zarówno oparte na szablonach, jak i nie — używają wskaźnika typu POSITION , aby opisać daną pozycję w kolekcji. Aby uzyskać dostęp do co najmniej jednego członka tych kolekcji, należy najpierw zainicjować wskaźnik położenia, a następnie wielokrotnie przekazać to położenie do kolekcji i poprosić o zwrócenie następnego elementu. Kolekcja nie jest odpowiedzialna za utrzymywanie informacji o stanie postępu iteracji. Te informacje są przechowywane w wskaźniku pozycji. Jednak biorąc pod uwagę określoną pozycję, kolekcja jest odpowiedzialna za zwrócenie następnego elementu.

Poniższe procedury pokazują, jak iterować w trzech głównych typach kolekcji dostarczanych z MFC:

• Iterowanie tablicy

• Iterowanie listy

• Iterowanie mapy

Aby iterować tablicę

1. Użyj liczb indeksu sekwencyjnego z funkcją składową GetAt :

   CTypedPtrArray<CObArray, CPerson *> myArray;
   
   myArray.Add(new CPerson());
   for (int i = 0; i < myArray.GetSize(); i++)
   {
      CPerson *thePerson = myArray.GetAt(i);
      thePerson->AssertValid();
   }
   

   W tym przykładzie użyto tablicy wskaźników wpisanych, która zawiera wskaźniki do CPerson obiektów. Tablica pochodzi z klasy CObArray, jednej z wstępnie zdefiniowanych klas. GetAt Zwraca wskaźnik do CPerson obiektu. W przypadku klas kolekcji wskaźników typowanych — tablic lub list — pierwszy parametr określa klasę bazową; drugi parametr określa typ do przechowywania.

   Klasa CTypedPtrArray przeciąża również operator [ ] , aby można było użyć niestandardowej składni indeksu dolnego tablicy w celu uzyskania dostępu do elementów tablicy. Alternatywą dla instrukcji w treści powyższej for pętli jest

   CPerson *thePerson = myArray[i];
   

   Ten operator istnieje zarówno w wersjach, jak const i innychconst niż. Wersja const wywoływana dla const tablic może być wyświetlana tylko po prawej stronie instrukcji przypisania.

Aby iterować listę

1. Użyj funkcji GetHeadPosition składowych i GetNext do pracy z listą:

   CTypedPtrList<CObList, CPerson *> myList;
   
   myList.AddHead(new CPerson());
   POSITION pos = myList.GetHeadPosition();
   while (pos != NULL)
   {
      CPerson *thePerson = myList.GetNext(pos);
      thePerson->AssertValid();
   }
   

   W tym przykładzie użyto wpisanej listy wskaźników, aby zawierać wskaźniki do CPerson obiektów. Deklaracja listy przypomina deklarację dla tablicy w procedurze Iteracja tablicy , ale pochodzi z klasy CObList. GetNext Zwraca wskaźnik do CPerson obiektu.

Aby iterować mapę

1. Użyj GetStartPosition polecenia , aby przejść na początek mapy i GetNextAssoc wielokrotnie pobierać następny klucz i wartość z mapy, jak pokazano w poniższym przykładzie:

   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
   }
   

   W tym przykładzie użyto prostego szablonu mapy (a nie kolekcji wskaźnika typizowanego), który używa CString kluczy i przechowuje wskaźniki do CPerson obiektów. W przypadku korzystania z funkcji dostępu, takich jak GetNextAssoc, klasa udostępnia wskaźniki do CPerson obiektów. Jeśli zamiast tego używasz jednej z kolekcji map nienależących do tablicy, musisz rzutować zwrócony CObject wskaźnik na wskaźnik na CPerson.

   Uwaga

   W przypadku map nontemplate kompilator wymaga odwołania do CObject wskaźnika w ostatnim parametrze do GetNextAssoc. W danych wejściowych należy rzutować wskaźniki do tego typu, jak pokazano w następnym przykładzie.

   Rozwiązanie szablonu jest prostsze i pomaga zapewnić lepsze bezpieczeństwo typów. Kod nontemplate jest bardziej skomplikowany, jak widać tutaj:

   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 ...
   }
   

Aby uzyskać więcej informacji, zobacz Usuwanie wszystkich obiektów w kolekcji CObject.

Zobacz też

Kolekcje