AddElement()

Синтаксис

*Result = AddElement(List())

Описание

Добавляет новый пустой элемент после текущего элемента, или в качестве первого элемента в Связном Списке List(), если в нем ещё нет элементов. Этот новый элемент становится текущим элементом Списка.

Параметры

List()

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

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

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

Пример

; Самый простой способ использования AddElement
NewList simple.w()
AddElement(simple()) ; Создает первый новый элемент в Списке
simple() = 23

AddElement(simple()) ; Текущее положение - это первый элемент, поэтому мы добавляем элемент во вторую позицию
simple() = 45

; Здесь показывается, как использовать возвращаемое значение AddElement
NewList advanced.l()
If AddElement(advanced()) <> 0
    advanced() = 12345
Else
    MessageRequester("Ошибка!", "Невозможно выделить память для нового элемента", #PB_MessageRequester_Ok)
EndIf

; Небольшая структура, демонстрирующая использование указателя на новый элемент
Structure Programmer
    Name.s
    Strength.b
EndStructure

NewList Programmers.Programmer() ; Список для хранения элементов

*Element.Programmer = AddElement(Programmers())
If *Element<>0
    *Element\Name = "Dave"
    *Element\Strength = 3  ; Сильный!
Else
    MessageRequester("Ошибка!", "Невозможно выделить память для нового элемента", #PB_MessageRequester_Ok)
EndIf

См. также

InsertElement(), DeleteElement(), ClearList()

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

Все