DeleteElement()

Синтаксис

*Result = DeleteElement(List() [, Flags])

Описание

Удаляет текущий элемент Связного Списка List(). После этого, новым текущим элементом становится предыдущий элемент (тот, который был перед удаленным элементом). Если вы удалили единственный элемент в Списке, то текущего элемента не будет, так как позиция в Списке находится 'перед первым элементом', так же как и после команды ResetList().

Параметры

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

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

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

Пример

NewList people.s()

AddElement(people()) : people() = "Tom"
AddElement(people()) : people() = "Dick"
AddElement(people()) : people() = "Harry"
AddElement(people()) : people() = "Bob"

FirstElement(people())
DeleteElement(people(), 1)
MessageRequester("Инфо", "Первый человек в Списке "+people(), #PB_MessageRequester_Ok)

LastElement(people()) ; Переход к "Bob"
PreviousElement(people()) ; Переход к "Harry"
DeleteElement(people()) ; И удаляет его. Перед Harry есть элемент, поэтому он становится текущим
MessageRequester("Инфо", "Текущий человек в Списке "+people(), #PB_MessageRequester_Ok)

См. также

AddElement(), InsertElement(), ClearList()

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

Все