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

Класс 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> )

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

Имя

Описание

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 сохраняется в архив с помощью перегруженного оператора вставки или функции-члена Serialize, каждый элемент сериализуется.

Примечание

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

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

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

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

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

CObject

CStringArray

Требования

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

См. также

Ссылки

Класс CObject

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