Langage BASICListes

MergeLists

Commande de liste

Syntaxe

Déplace tous les éléments d'une liste dans une autre. La liste source finit vide.

MergeLists(<source>(), <destination>() [, <where>])

Les éléments

<source>La liste d'où viennent les éléments, avec ses parenthèses. Elle est vide ensuite et n'a plus d'élément courant.
<destination>La liste qui reçoit les éléments, avec ses parenthèses.
<where>Facultatif. #AK_LIST_LAST (par défaut) ajoute à la fin, #AK_LIST_FIRST au début, #AK_LIST_BEFORE ou #AK_LIST_AFTER avant ou après l'élément courant de la destination.

À savoir

  • Ne renvoie rien : écrivez-le seul sur sa ligne.
  • Les éléments sont déplacés, pas copiés. Utilisez CopyList() pour garder la source.
  • La destination garde le même élément courant.
  • Le programme s'arrête si les deux arguments sont la même liste, si les types diffèrent, ou si #AK_LIST_BEFORE ou #AK_LIST_AFTER est demandé alors que la destination n'a pas d'élément courant.

Exemple

NewList a.integer()NewList b.integer()FOR k = 1 TO 2  AddElement(a())  a() = k  AddElement(b())  b() = k * 10NEXTFirstElement(b())MergeLists(a(), b(), #AK_LIST_AFTER)Console(Str(ListSize(a())))   ' 0FOREACH b()  Console(Str(b()))   ' 10, 1, 2, 20NEXT
Dans le manuel : Tableaux, listes et maps

Voir aussi