MergeLists()

Syntaxe

MergeLists(ListeSource(), ListeDestination() [, Location])
Description
Déplace tous les éléments de la liste ListeSource() vers la liste ListeDestination().

Arguments

ListeSource() La liste à partir de laquelle les éléments seront pris. Cette liste sera vide après l'opération.
ListeDestination() La liste vers laquelle les éléments seront déplacés. Cette liste contiendra les éléments des deux listes.
Location (optionnel) Indique l'emplacement où les éléments seront insérés dans la liste ListeDestination(). Peut être une des valeurs suivantes:
  #PB_List_First : Insère les éléments au début de ListeDestination()
  #PB_List_Last  : Ajoute des éléments à la fin de ListeDestination()
  #PB_List_Before: Insère les éléments avant l'élément courant de ListeDestination()
  #PB_List_After : Insère les éléments après l'élément courant de ListeDestination()

Valeur de retour

Aucune.

Remarques

Cette opération est rapide car les données elles-même ne sont pas déplacées.

Exemple

  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"
    
  ; Insère les éléments de A() avant l'élément "b1" de B()
  SelectElement(B(), 1)
  MergeLists(A(), B(), #PB_List_Before)
  
  ForEach B()
    Debug B()
  Next

Voir aussi

SplitList()

OS Supportés

Tous

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