Класс CStringArray

Статья
02/20/2013

Поддерживает массивы объектов CString.

class CStringArray : public CObject

Члены

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

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

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

CString CStringArray::GetAt( int <nIndex> ) const;

void SetAt( int <nIndex>, CObject* <newElement> )

преобразует значение

void SetAt( int <nIndex>, LPCTSTR <newElement> )

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

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

Заметки

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

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

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

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

Если массив CString удаления или при его элементы удалены, память строки освобождается в качестве подходящего.

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

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

CObject

CStringArray

Требования

Header: afxcoll.h

См. также

Ссылки

Класс CObject

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

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