Класс CWordArray

  • Статья

Поддерживает массивы 16-разрядных слов.

Синтаксис

class CWordArray : public CObject

Участники

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

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

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

WORD CWordArray::GetAt( int <nIndex> ) const;

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

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

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

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

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

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

Замечания

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

Примечание.

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

Если вам нужен дамп отдельных элементов в массиве, необходимо задать глубину контекста дампа 1 или больше.

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

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

CObject

CWordArray

Требования

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

См. также

Пример MFC COLLECT
Класс CObject
Диаграмма иерархии