Класс 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
см. в статье "Коллекции".
Иерархия наследования
CStringArray
Требования
Заголовок: afxcoll.h