Класс CPtrArray

Примечание.

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Поддерживает массивы пустых указателей.

Синтаксис

class CPtrArray : public CObject

Участники

Функции-члены похожи на функции-члены CPtrArray класса CObArray. Из-за этой схожести для изучения этой функции-члена можно использовать справочную документацию по классу CObArray. Где бы вы ни видели CObject указатель в качестве параметра функции или возвращаемого значения, замените указатель на void.

CObject* CObArray::GetAt( int <nIndex> ) const;

, например, преобразуется в

void* CPtrArray::GetAt( int <nIndex> ) const;

Открытые конструкторы

Имя	Описание
CPtrArray::CPtrArray	Создает пустой массив.

Открытые методы

Имя	Описание
CPtrArray::Add	Добавляет элемент в конец массива. При необходимости размер массива увеличивается.
CPtrArray::Append	Добавляет другой массив к массиву. При необходимости размер массива увеличивается.
CPtrArray::Copy	Копирует другой массив в этот массив. При необходимости размер массива увеличивается.
CPtrArray::ElementAt	Возвращает временную ссылку на указатель элемента в массиве.
CPtrArray::FreeExtra	Освобождает всю неиспользуемую память сверх текущей верхней границы.
CPtrArray::GetAt	Возвращает значение по указанному индексу.
CPtrArray::GetCount	Возвращает количество элементов в массиве.
CPtrArray::GetData	Разрешает доступ к элементам в массиве. Может иметь значение NULL.
CPtrArray::GetSize	Возвращает количество элементов в массиве.
CPtrArray::GetUpperBound	Возвращает самый большой допустимый индекс.
CPtrArray::InsertAt	Вставляет элемент (или все элементы в другом массиве) по указанному индексу.
CPtrArray::IsEmpty	Определяет, пуст ли массив.
CPtrArray::RemoveAll	Удаляет все элементы из этого массива.
CPtrArray::RemoveAt	Удаляет элемент по указанному индексу.
CPtrArray::SetAt	Задает значение для указанного индекса. Размер массива не увеличивается.
CPtrArray::SetAtGrow	Задает значение для указанного индекса. При необходимости размер массива увеличивается.
CPtrArray::SetSize	Задает число элементов, которые будут храниться в этом массиве.

Открытые операторы

Имя	Описание
CPtrArray::operator [ ]	Получает или задает элемент с указанным индексом.

Замечания

CPtrArray включает макрос IMPLEMENT_DYNAMIC для поддержки доступа к типу выполнения и дампа в CDumpContext объект. Если вам нужен дамп отдельных элементов массива указателей, необходимо задать глубину контекста дампа 1 или больше.

Примечание.

Перед работой с массивом используйте функцию SetSize, чтобы определить его размер и выделить под него память. Если не использовать функцию SetSize, при добавлении элементов в массив он будет часто копироваться и для него снова и снова будет повторно выделяться память. Это может привести к ухудшению производительности и фрагментации памяти.

Невозможно сериализовать массивы указателей.

При удалении массива указателей или при удалении его элементов удаляются только указатели, а не сущности, на которые они ссылаются.

Дополнительные сведения об использовании CPtrArrayсм. в статье "Коллекции".

Иерархия наследования

CObject

CPtrArray

Требования

Заголовок: afxcoll.h

См. также

Класс CObject
Диаграмма иерархии
Класс CObArray