Поделиться через


CMapStringToOb::RemoveAll

Удаляет все элементы из этого раздела CString сопоставления и уничтожает объекты.

void RemoveAll( );

Заметки

Не уничтожены объекты, на которые ссылается CObject каждым ключом. Функция RemoveAll может вызвать утечку памяти если не указать, что CObject ссылочные объекты уничтожаются.

Функция работает правильно, если сопоставление уже является пустым.

В следующей таблице приведены другие функции-члены, которые похожи на CMapStringToOb::RemoveAll.

Класс

Функция-член

CMapPtrToPtr

RemoveAll (пустое);

CMapPtrToWord

RemoveAll (пустое);

CMapStringToPtr

RemoveAll (пустое);

CMapStringToString

RemoveAll (пустое);

CMapWordToOb

RemoveAll (пустое);

CMapWordToPtr

RemoveAll (пустое);

Пример

См. перечисление CObList::CObList для класса CAge, используемого во всех примерах коллекции.

{
   CMapStringToOb map;

   CAge age1(13); // Two objects on the stack
   CAge age2(36);
   map.SetAt(_T("Bart"), &age1);
   map.SetAt(_T("Homer"), &age2);
   ASSERT(map.GetCount() == 2);
   map.RemoveAll(); // CObject pointers removed; objects not removed.
   ASSERT(map.GetCount() == 0);
   ASSERT(map.IsEmpty());
} // The two CAge objects are deleted when they go out of scope.         

Требования

Header: afxcoll.h

См. также

Ссылки

Класс CMapStringToOb

Диаграмма иерархии

CMapStringToOb::RemoveKey