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


Класс 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 Класс
Диаграмма иерархии