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

List Inhaltsverzeichnis - ChangeCurrentElement() ->