AddElement()
Syntax
*Ergebnis = AddElement(Liste())Beschreibung
Fügt ein neues, leeres Listenelement nach dem aktuellen Element ein oder als erstes Element, wenn die Liste noch keine Elemente enthält. Dieses neue Element wird zum aktuellen Element der Liste.
Parameter
Liste() Der Variablenname der verknüpften Liste, welche mit dem NewList Befehl erstellt wurde. Sie müssen die Klammern nach dem Listennamen immer angeben.
Rückgabewert
Gibt einen Wert ungleich Null zurück, wenn das neue Element erstellt wurde, andernfalls Null. Der zurückgegebene Wert ist ein Zeiger auf die Daten des neuen Elements.
Beispiel
; Der einfachste Weg zur Benutzung von AddElement
NewList simple.w()
AddElement(simple()) ; Erstellt das erste neue Element innerhalb der Liste
simple() = 23
AddElement(simple()) ; Aktuelle Position ist das erste Element, wir fügen
simple() = 45 ; daher ein neues an der zweiten Position ein
; Das nachfolgende Beispiel zeigt die Benutzung des Rückgabewerts von AddElement
NewList advanced.l()
If AddElement(advanced()) <> 0
advanced() = 12345
Else
MessageRequester("Fehler!", "Kein Speicherplatz zum Reservieren des neuen Elements", #PB_MessageRequester_OK)
EndIf
; Eine kleine Struktur, um die Verwendung des Zeigers auf das neue Element zu demonstrieren
Structure Programmer
Name.s
Strength.b
EndStructure
NewList Programmers.Programmer() ; Die Liste zum Speichern der Elemente
*Element.Programmer = AddElement(Programmers())
If *Element<>0
*Element\Name = "Dave"
*Element\Strength = 3 ; Wow, super-strong geek! ;)
Else
MessageRequester("Fehler!", "Kein Speicherplatz zum Reservieren des neuen Elements", #PB_MessageRequester_OK)
EndIf
Siehe auch
InsertElement(), DeleteElement(), ClearList()
Unterstützte OS
Alle