gettagstringlist

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

Синтаксис:

tag = gettagstringlist(s_id, indx);

Аргументы:

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

indx – номер строки, для которой получается метка.

Описание:

getagtstringlist(s_id, indx) – функция получения метки строки по номеру строки indx из списка строк с идентификатором s_id. Нумерация строк в списке начинается с нуля.

Результат:

tag – возвращаемая метка. Имеет тип integer.

Пример:

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

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

Сопутствующие материалы