Доступ ко всем членам коллекции

Статья
06/16/2023

Для доступа к своим элементам классы коллекций массивов MFC (как шаблонные, так и нешаблонные) используют индексы. Для описания в заданной позиции в коллекции классы коллекций списков и схем MFC (как шаблонные, так и нешаблонные) используют индикатор типа POSITION . Чтобы получить доступ к одному или нескольким членам этих коллекций, сначала следует инициализировать индикатор позиции, а затем повторно передавать эту позицию в коллекцию с запросом на возврат следующего элемента. Коллекция не отвечает за поддержание сведений о состоянии хода выполнения итерации. Эта информация хранится в индикаторе позиции. Однако, принимая во внимание конкретную позицию, коллекция отвечает за возврат следующего элемента.

В приведенных далее процедурах показана итерация в трех основных типах коллекций в MFC.

Итерация массива
Итерация списка
Итерация схемы

Итерация массива

Используйте последовательные номера индекса с функцией-членом GetAt .
```
CTypedPtrArray<CObArray, CPerson *> myArray;

myArray.Add(new CPerson());
for (int i = 0; i < myArray.GetSize(); i++)
{
   CPerson *thePerson = myArray.GetAt(i);
   thePerson->AssertValid();
}
```
В этом примере используется массив типизированных указателей, который содержит указатели на объекты CPerson . Массив является производным от класса CObArray, одного из нешаблонных предопределенных классов. GetAt возвращает указатель на объект CPerson . Для классов коллекций типизированных указателей (массивов или списков) первый параметр указывает базовый класс, второй параметр указывает тип для хранения.

Класс CTypedPtrArray также перегружает оператор [ ] , чтобы можно было использовать обычный синтаксис массива для доступа к элементам массива. Альтернативой инструкции в теле приведенного выше цикла for является
```
CPerson *thePerson = myArray[i];
```
Этот оператор существует как в, так const и в версиях, отличныхconst от версии. Версия const , которая вызывается для const массивов, может отображаться только в правой части инструкции назначения.

Итерация списка

Для прохода по списку используйте функции-члены GetHeadPosition и GetNext :
```
CTypedPtrList<CObList, CPerson *> myList;

myList.AddHead(new CPerson());
POSITION pos = myList.GetHeadPosition();
while (pos != NULL)
{
   CPerson *thePerson = myList.GetNext(pos);
   thePerson->AssertValid();
}
```
В этом примере используется список типизированных указателей, который содержит указатели на объекты CPerson . Объявление списка напоминает объявление для массива в процедуре Итерация массива , но является производным от класса CObList. GetNext возвращает указатель на объект CPerson .

Итерация схемы

Используйте GetStartPosition для перехода в начало схемы и GetNextAssoc для повторного получения следующего ключа и значения из схемы, как показано в следующем примере.
```
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
}
```
В этом примере применяется шаблон простой схемы (а не коллекция типизированных указателей), использующий ключи CString и сохраняющий указатели на объекты CPerson . При использовании функций доступа, таких как GetNextAssoc, класс предоставляет указатели на объекты CPerson . При использовании одной из коллекций нешаблонных схем необходимо привести возвращенный указатель CObject к указателю на CPerson.

Примечание.

При работе с нешаблонными схемами компилятору требуется ссылка на указатель CObject в последнем параметре на GetNextAssoc. При воде данных необходимо привести указатели к этому типу, как показано в следующем примере.

Шаблонное решение проще в использовании и помогает обеспечить более высокий уровень безопасности типов. Как видно из примера ниже, нешаблонный код более сложен.
```
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 ...
}
```

Дополнительные сведения см. в разделе Удаление всех объектов из коллекции CObject.

См. также

Коллекции

Share via