Класс CStringArray

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

Синтаксис

class CStringArray : public CObject

Участники

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

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

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

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

и

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

преобразуется в

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

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

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

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

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

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

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

Замечания

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

Примечание.

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

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

При удалении массива CString или его элементов, строковая память освобождается соответствующим образом.

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

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

CObject

CStringArray

Требования

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

См. также

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