MergeLists()

Syntax

MergeLists(QuellListe(), ZielListe() [, Lokation])
Beschreibung
Verschiebt alle Elemente von der QuellListe() zur ZielListe(). Dies ist eine schnelle Operation, da die Element-Daten selber nicht verschoben werden, um die zwei Listen zusammenzuführen (englisch "to merge").

Parameter

QuellListe() Die Liste, aus der die Elemente genommen werden. Diese Liste wird leer sein, nachdem diese Funktion abgeschlossen ist.
ZielListe() Die Liste, wohin die Elemente verschoben werden. Diese Liste wird die Elemente beider Listen beinhalten, nachdem diese Funktion abgeschlossen ist.
Lokation (optional) Position, wo die Elemente in der ZielListe() eingefügt werden. Dies kann einer der folgenden Werte sein:
  #PB_List_Last  : Hängt die Elemente am Ende der ZielListe() an  (Standard)
  #PB_List_First : Fügt die Elemente am Anfang der ZielListe() ein
  #PB_List_Before: Fügt die Elemente vor dem aktuellen Element der ZielListe() ein
  #PB_List_After : Fügt die Elemente nach dem aktuellen Element der ZielListe() ein

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Beispiel

  NewList A.s()
  AddElement(A()): A() = "a0"
  AddElement(A()): A() = "a1"
  AddElement(A()): A() = "a2"
  AddElement(A()): A() = "a3"
  
  NewList B.s()
  AddElement(B()): B() = "b0"
  AddElement(B()): B() = "b1"
  AddElement(B()): B() = "b2"
  AddElement(B()): B() = "b3"
    
  ; Fügt die Elemente von A() vor dem "b1" Element in B() ein
  SelectElement(B(), 1)
  MergeLists(A(), B(), #PB_List_Before)
  
  ForEach B()
    Debug B()
  Next

Siehe auch

SplitList()

Unterstützte OS

Alle

<- ListSize() - List Inhaltsverzeichnis - MoveElement() ->