setstringlist

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

Синтаксис:

n = setstringlist(s_id, indx, str, tag);

Аргументы:

Имя Тип данных Описание
s_id integer Идентификатор списка строк
indx integer Индекс позиции в списке строк для вставляемой строки
str string Вставляемая строка
tag integer Метка строки

Описание:

setstringlist(s_id, indx, str, tag) – функция вставки строки str с меткой tag на позицию с номером indx в список строк с идентификатором s_id. Нумерация строк в списке начинается с нуля. Строка вставляется вместо строки на позиции indx. Возвращается номер позиции вставленной строки.

Результат:

Имя Тип данных Описание
n integer Номер позиции вставленной строки

Пример:

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

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

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

Нет.