NextElement()

Синтаксис

*Result = NextElement(List())

Описание

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

Параметры

List()

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

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

Возвращает адрес в памяти нового текущего элемента Списка. При отсутствии следующего элемента в Списке возвратом будет 0. Возвращаемое значение является указателем на новый текущий элемент.

Пример

NewList Scores.w()

For i=1 To 10
    AddElement(Scores())
    Scores() = 100 - i
Next

ResetList(Scores())
While NextElement(Scores())
    ; Это нормально, так как первый вызов NextElement() укажет текущим элементом первый элемент в Списке
    MessageRequester("Score", Str(Scores()), #PB_MessageRequester_Ok)
Wend

См. также

ResetList(), PreviousElement(), FirstElement(), LastElement(), SelectElement(), ListIndex()

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

Все