Учись программированию на C++ Builder бесплатно!

Описание


Функция Add добавляет новый элемент в список. Если список не сортированный, то элемент добавляется в конец списка. Если же список сортированный, то новый элемент добавляется в позицию, которая определяется сортировкой. Функция возвращает индекс добавленного элемента (индекс первого элемента - 0). Увеличивает значение свойства Count на 1. Если значение Count равно значению Capacity (емкости массива), то увеличивается значение Capacity (с запасом) и перераспределяется память под новые элементы.

Для сортированного списка TStringList при выполнении Add генерируется исключение EListError, если строка S уже имеется в списке и свойство Duplicates установлено в dupError.

Классы


TList
TSiringList
TStrings

Определение


TList:

int __fastcall Add(void * Item);

TStrings и TStringList:

virtual int, _fastcall Add(const System::AnsiString S);

Пример


TStringList *TL = new TStringList;
TL->Sorted - true;
TL->Duplicates = dupError;
TL->Add("Петров");
int i = TL->Add("Иванов");
TL->Add("Иванов");
Поделиться