SplitList()

Syntax

SplitList(QuellListe(), ZielListe() [, ErhalteAktuelles])
Beschreibung
Verschiebt die Elemente der QuellListe() vom aktuellen Element an vorwärts zur ZielListe(). Dies ist eine schnelle Operation, da die Element-Daten selber nicht verschoben werden, um die Listen zu teilen (englisch "to split").

Parameter

QuellListe() Die Liste, aus der die Elemente abgeteilt ("gesplittet") werden. Das aktuelle Element dieser Liste gibt an, wo die Liste geteilt werden soll. Gibt es kein aktuelles Element, verbleiben alle Elemente in der QuellListe().
ZielListe() Die Liste, wohin die Elemente verschoben werden. Alle in dieser Liste existierenden Elemente werden gelöscht, bevor die neuen Elemente hinzugefügt werden.
ErhalteAktuelles (optional) (englisch "KeepCurrent") Gibt an, ob der aktuelle Eintrag der QuellListe() in der QuellListe() verbleibt, oder in die ZielListe() verschoben wird. Ist dieser Parameter gleich #True, dann verbleibt das aktuelle Element in der QuellListe(). Lautet er #False (Standard), dann wird das aktuelle Element in die ZielListe() verschoben.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

Wenn 'ErhalteAktuelles' ("KeepCurrent") auf #True gesetzt wird, dann wird das vorherige Element das neue aktuelle Element in der QuellListe(). Gibt es kein vorheriges Element, dann wird die Liste nach Abschluss dieser Funktion kein aktuelles Element mehr haben. Die ZielListe() hat kein aktuelles Element.

Beispiel

  NewList A()
  NewList B()
  
  For i = 0 To 10
    AddElement(A())
    A() = i
  Next i
  
  ; teilt A() am Element 5 und verschiebt die verbleibenden Elemente nach B()
  SelectElement(A(), 5)
  SplitList(A(), B())
  
  
  Debug " -- A() -- "
  ForEach A()
    Debug A()
  Next
  
  Debug " -- B() -- "
  ForEach B()
    Debug B()
  Next

Siehe auch

MergeLists()

Unterstützte OS

Alle

<- SelectElement() - List Inhaltsverzeichnis - SwapElements() ->