DeleteElement()

Syntax

*Ergebnis = DeleteElement(Liste() [, Flags])
Beschreibung
Entfernt das aktuelle Element aus der Liste. Nach dem Aufruf dieser Funktion wird das vorherige Element (dasjenige vor dem gelöschten Element) neues aktuelles Element. Wenn dieses Element nicht existiert (mit anderen Worten: Sie haben das erste Element in der Liste gelöscht), dann gibt es kein aktuelles Element mehr, da es sich vor dem ersten Element befindet, wie nach einem ResetList().

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.
Flags (optional) Wenn dieser Parameter auf 1 gesetzt wird und dann das erste Element gelöscht wird, wird das zweite Element (dasjenige nach dem gelöschten Element) das neue aktuelle Element sein. Dieses Flag stellt sicher, dass nach dem Löschen immer ein gültiges aktuelles Element vorhanden ist, solange es noch Elemente in der Liste gibt.

Rückgabewert

Gibt die Speicheradresse des neuen aktuellen Elements in der Liste zurück. Falls die Liste nach der Löschung kein aktuelles Element hat, ist das Ergebnis gleich 0.

Beispiel

  NewList people.s()

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

  FirstElement(people())     ; Bewegt sich zu "Tom"
  DeleteElement(people(), 1) ; Löscht "Tom". Da sich kein weiteres Element davor befand, wird "Dick" neues aktuelles Element.
  MessageRequester("Information", "Erste Person in der Liste ist "+people(), #PB_MessageRequester_Ok) 

  LastElement(people())      ; Bewegt sich zu "Bob"
  PreviousElement(people())  ; Bewegt sich zu "Harry"
  DeleteElement(people())    ; und löscht ihn. Es gibt ein Element vor Harry, daher wird dies das aktuelle.
  MessageRequester("Information", "Aktuelle Person in der Liste ist "+people(), #PB_MessageRequester_Ok)

Siehe auch

AddElement(), InsertElement(), ClearList()

Unterstützte OS

Alle

<- CountList() - List Inhaltsverzeichnis - FirstElement() ->