Описание
Функция 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("Иванов");