Класс CStringArray

Поддерживает массивы объектов 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> )

tddz3etf.collapse_all(ru-ru,VS.110).gifОткрытые конструкторы

Имя

Описание

CObArray::CObArray

Создает пустой массив.

tddz3etf.collapse_all(ru-ru,VS.110).gifОткрытые методы

Имя

Описание

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

Задает количество элементов, которое должно содержаться в этом массиве.

tddz3etf.collapse_all(ru-ru,VS.110).gifОткрытые операторы

Имя

Описание

CObArray::operator []

Получает или задает элемент по указанному индексу.

Заметки

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

ПримечаниеПримечание

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

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

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

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

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

CObject

CStringArray

Требования

Header: afxcoll.h

См. также

Ссылки

Класс CObject

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