Класс TStringList |
Наверх Предыдущая Последующая | |
Для работы с текстовыми файлами и массивами строк в скриптовом языке поддерживается класс 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;
Возвращает количество строк в списке. Допускает только чтение.