Класс TStringList

Класс TStringList

Previous pageReturn to chapter overviewNext page

Для работы с текстовыми файлами и массивами строк в скриптовом языке поддерживается класс TStringList, идентичный аналогичному классу в Delphi. Данный класс позволяет:

Создавать списки строк и осуществлять их обработку;

Производить поиск строк и сортировку;

Работать с текстовыми файлами;

Осуществлять особую обработку массивов строк вида "имя=значение";

 

 

Методы:

 

constructor Create;

Создает экземпляр класса. Попытка работы с экземпляром класса до его создания или после разрушения приведет к ошибке.

 

destructor Free;

Разрушает экземпляр класса, освобождает все занятые им ресурсы.

 

function Add(const S: string): Integer;

Добавляет строку к списку, возвращаемое значение - позиция элемента в списке (позиция отсчитывается от 0).

 

procedure Append(const S: string);

Аналогично Add, но не возвращает позицию добавленного элемента

 

procedure Clear;

Очищает список строк

 

procedure Delete(Index: Integer);

Удаляет строку с указанным индексом. Указание недопустимого индекса является ошибкой

 

procedure Move(CurIndex, NewIndex: Integer); virtual;

Перемещает элемент CurIndex в позицию NewIndex. Указание недопустимого индекса является ошибкой

 

function IndexOf(const S: string): Integer;

Поиск указанной строки в массиве. Если строка найдена, то возвращается ее индекс, если не найдена - значение -1.

 

procedure Insert(Index: Integer; const S: string);

Вставляет строку по указанному индексу (раздвигая массив). Например, Insert(0, 'First string !') вставит текст 'First string !' в начало массива строк

 

procedure LoadFromFile(const FileName: string);

Загружает текстовый файл с именем FileName в список строк. Имеющиеся при этом в списке данные затираются.

 

procedure SaveToFile(const FileName: string);

Загружает список строк в текстовый файл с именем FileName. Имеющиеся при этом в списке данные не изменяются.

 

Свойства

 

property Count: Integer;

Возвращает количество строк в списке. Допускает только чтение.