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