SplitList()

Syntaxe

SplitList(ListeSource(), ListeDestination() [, GarderElementCourant])

Découpe une liste en deux. Déplace les éléments de la liste ListeSource(), l'élément courant y compris, vers la liste ListeDestination(). Cette opération est rapide car les données elles-même ne sont pas déplacées.

Arguments

ListeSource()	La liste à partir de laquelle les éléments seront déplacés. L'élément courant de la liste précise le point de division de la liste. S'il n'y a pas d'élément courant, alors tous les éléments restent dans ListeSource().
ListeDestination()	La liste vers laquelle les éléments seront déplacés. Tous les éléments existants dans cette liste sont supprimés avant l'ajout des nouveaux éléments.
GarderElementCourant (optionnel)	Indique si l'élément courant de ListeSource() reste dans ListeSource() ou s'il est déplacé vers ListeDestination(). Si ce paramètre est #True alors l'élément courant reste dans ListeSource(). S'il est #False (par défaut) alors l'élément courant est déplacé vers ListeDestination().

Valeur de retour

Cette fonction n'a pas de valeur de retour.

Remarques

Si 'GarderElementCourant' est fixé à #True alors le nouvel élément courant dans ListeSource() sera l'élément précédent de la liste. S'il n'y a pas d'élément précédent alors la liste n'aura plus d'élément courant. La ListeDestination() n'aura aucun élément courant.

Exemple

  NewList A()
  NewList B()
  
  For i = 0 To 10
    AddElement(A())
    A() = i
  Next i
  
  ; Coupe en deux la liste A() à l'élément 5 et déplace les éléments restants dans la liste B()
  SelectElement(A(), 5)
  SplitList(A(), B())
  
  
  Debug " -- A() -- "
  ForEach A()
    Debug A()
  Next
  
  Debug " -- B() -- "
  ForEach B()
    Debug B()
  Next

Voir aussi

MergeLists()

OS Supportés

Tous