PureBasic

ListIndex()

Синтаксис

Index = ListIndex(List())

Описание


Возвращает позицию текущего элемента в Связном Списке List(), учитывая, что первый элемент находится в позиции 0. Эта функция очень быстрая, потому что не перебирает весь Список, а использует предварительно вычисленные значения, поэтому при интенсивном использовании функция не сказывается на производительности приложения.

Параметры

List() Имя используемого Списка, созданного с помощью функции NewList. Вы должны указать скобки после имени Списка.

Возвращаемое значение

Индекс, указывающий позицию текущего элемента в Списке. Первый элемент находится в позиции 0, следующий в 1 и так далее. Значение -1 означает, что текущий элемент отсутствует (либо Список пуст, либо использовалась команда ResetList()).

Пример

NewList fruit.s()

AddElement(fruit()) : fruit() = "oranges"
AddElement(fruit()) : fruit() = "bananas"
AddElement(fruit()) : fruit() = "apples"
AddElement(fruit()) : fruit() = "pears"

FirstElement(fruit())
MessageRequester("Fruit: "+fruit(), "Теперь на позиции "+Str(ListIndex(fruit())),  #PB_MessageRequester_Ok)

NextElement(fruit())
MessageRequester("Fruit: "+fruit(), "Теперь на позиции "+Str(ListIndex(fruit())),  #PB_MessageRequester_Ok)

NextElement(fruit())
MessageRequester("Fruit: "+fruit(), "Теперь на позиции "+Str(ListIndex(fruit())),  #PB_MessageRequester_Ok)

NextElement(fruit())
MessageRequester("Fruit: "+fruit(), "Теперь на позиции "+Str(ListIndex(fruit())),  #PB_MessageRequester_Ok)

См. также

SelectElement(), ListSize()

Поддерживаемые OS

Все

<- LastElement() - Оглавление List - ListSize()->