insertstringlist

Синтаксис

indx = addstringlist(s_id, indx, str, tag);

Аргументы


Имя	Тип данных	Описание
s_id	`integer`	Идентификатор списка строк
indx	`integer`	Индекс добавляемой строки в списке строк (нумерация начинается с нуля)
str	`string`	Добавляемая строка
tag	`integer`	Метка строки

Описание

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

Результат


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

Пример

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

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

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

Нет.