Класс CObArray

Статья
02/20/2013

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

class CObArray : public CObject

Члены

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

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

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

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

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

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

Заметки

Эти массивы объектов похожи на массивы c#, однако они могут динамически сжатие и увеличиваться по мере необходимости.

Индекс массива, начиная всегда в позиции 0.Можно выбрать, следует ли разрешить исправить границы или массив, чтобы развернуть при добавлении элементов за границами текущего.Память выделена сопредельн на границе, даже если некоторые элементы равны null.

В Win32, размер объекта CObArray ограничивается только доступной памятью.

Как и в случае с массивом c время выборки для элемента индексированного CObArray постоянным и не зависит от размера массива.

CObArray содержит макрос IMPLEMENT_SERIAL для поддержки сериализации и сбрасывать его элементов.Если массив указателей CObject хранится в архив или с перегруженным оператора insert или функцией-членом Serialize, то каждый элемент CObject, в свою очередь, сериализован вместе с своим индексом массива.

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

Если объект CObArray удаления или при его элементы удалены только указатели CObject, а не объекты удалены они ссылаются.

Примечание
Перед использованием массива, используйте SetSize чтобы установить его размер и выделить память для него.Если не используется SetSize, то добавление элементов в массив часто вызывают быть reallocated и скопировать его.Частое переразмещение и копирование неработоспособны и может разделить память.

Перед использованием массива, используйте SetSize чтобы установить его размер и выделить память для него.Если не используется SetSize, то добавление элементов в массив часто вызывают быть reallocated и скопировать его.Частое переразмещение и копирование неработоспособны и может разделить память.

Источник класса массива похож на вывод списка.Дополнительные сведения о выводе одноцелевого класса списка см. в статье коллекции.

Примечание
Необходимо использовать макрос IMPLEMENT_SERIAL в реализации производного класса, если планируется сериализация массива.