addstringlist

Функция добавления строки в конец списка строк.

Синтаксис:

indx = addstringlist(s_id, str, tag);

Аргументы:

s_id – идентификатор списка строк,

str – добавляемая строка,

tag – метка строки.

Описание:

addstringlist(s_id, str, tag) – функция добавления строки с меткой tag в конец списка строк с идентификатором s_id.

Результат:

indx – индекс добавленной строки в списке строк (нумерация начинается с нуля).

Пример:

var
s_01:string = "string1" + chr(10) + "string2",
s_02:string = "string3";
//создание списка строк 
slist = createstringlist;
//загрузим строку s_01 в список
settextstringlist(slist, s_01);
//добавим строку s_02 в список 
i = addstringlist(slist, s_02, 0);
//уничтожим список                
freeobject(slist);

В процессе выполнения примера при помощи функции createstringlist будет создан список строк с идентификатором slist. В список строк slist при помощи функции settextstringlist будет загружена строка, объявленная с разделителем «перевод строки», в результате чего переменная slist будет содержать идентификатор списка строк “”string1”“string2””. Далее, при помощи функции addstringlist в список строк с идентификатором slist будет загружена строка “string3”. В результате переменная slist будет содержать идентификатор списка строк “”string1”“string2”“string3””, переменной i будет присвоено значение 2. Перед завершением примера список строк удаляется при помощи функции freeobject.