Класс 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> )
Имя |
Описание |
---|---|
Создает пустой массив. |
Имя |
Описание |
---|---|
Добавляет элемент в конец массива; растет массив, если требуемый. |
|
Добавляет другой массив в массив. растет массив, если требуемый. |
|
Копирует другой массив в массив. растет массив, если требуемый. |
|
Возвращает временной ссылку на указатель элемента в массиве. |
|
Высвобождает всю неиспользуемую память над текущим границей. |
|
Возвращает значение по заданному индексу. |
|
Получает число элементов в данном массиве. |
|
Разрешает доступ к элементам массива.Может быть NULL. |
|
Получает число элементов в данном массиве. |
|
Возвращает максимальный допустимый индекс. |
|
Вставляет элемент (или все элементы в других массив) по указанному индексу. |
|
Определяет, если массив пуст. |
|
Удаляет все элементы из этого массива. |
|
Удаляет элемент по указанному индексу. |
|
Задает значение для данного индекса; массив не разрешенный увеличиваться. |
|
Задает значение для данного индекса; растет массив, если требуемый. |
|
Задает количество элементов, которое должно содержаться в этом массиве. |
Имя |
Описание |
---|---|
Получает или задает элемент по указанному индексу. |
CStringArray содержит макрос IMPLEMENT_SERIAL для поддержки сериализации и сбрасывать его элементов.Если массив объектов CString хранится в архив или с перегруженным оператора insert или функцией-членом Serialize, то каждый элемент сериализации в свою очередь.
Примечание |
---|
Перед использованием массива, используйте SetSize чтобы установить его размер и выделить память для него.Если не используется SetSize, то добавление элементов в массив часто вызывают быть reallocated и скопировать его.Частое переразмещение и копирование неработоспособны и может разделить память. |
Если требуется дамп отдельных элементов строки в массиве, необходимо установить глубину контекста дампа значение 1 или больше.
Если массив CString удаления или при его элементы удалены, память строки освобождается в качестве подходящего.
Дополнительные сведения об использовании CStringArray см. в статье коллекции.
CStringArray
Header: afxcoll.h