addstringlist

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

Синтаксис:

indx = addstringlist(s_id, str, tag);

Аргументы:

Имя Тип данных Описание
s_id integer Идентификатор списка строк
str string Добавляемая строка
tag integer Метка строки

Описание:

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

Результат:

Имя Тип данных Описание
indx integer Индекс добавленной строки в списке строк (нумерация начинается с нуля)

Пример:

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.

Дополнительные материалы

Нет.