Класс CByteArray

Статья
06/10/2015

Поддерживает динамические массивы байтов.

class CByteArray : public CObject

Члены

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

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

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

BYTE CByteArray::GetAt( int <nIndex> ) const;

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

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

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

Имя	Описание
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 []	Получает или задает элемент по указанному индексу.

Заметки

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

Примечание

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

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

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

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

CObject

CByteArray

Требования

Header: afxcoll.h

См. также

Ссылки

Класс CObject

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

Класс CObArray

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