MoveElement()

Syntaxe

MoveElement(Liste(), Location [, *ElementRelatif])
Description
Déplace l'élément courant vers une autre position dans la liste.

Arguments

Liste() La liste à utiliser.
Location L'emplacement de l'élément courant. Peut être une des valeurs suivantes: 
  #PB_List_First : Déplacer l'élément vers le début de la liste
  #PB_List_Last  : Déplacer l'élément vers la fin de la liste
  #PB_List_Before: Déplacer l'élément avant le *ElementRelatif
  #PB_List_After : Déplacer l'élément après le *ElementRelatif
*ElementRelatif (optionnel)
Indique l'adresse d'un autre élément auprès duquel l'élément actuel doit être déplacé. Ce paramètre est requis lorsque le paramètre "Localisation" est #PB_List_Before ou #PB_List_After. Vous pouvez obtenir cette adresse en utilisant l'opérateur @ avec le nom de la liste.

Valeur de retour

Aucune.

Remarques

L'élément déplacé reste l'élément courant de la liste. Cette opération est rapide car la donnée elle-même n'est pas déplacée.

Exemple

  NewList Nombres()
  
  For k=0 To 10
    AddElement(Nombres())
    Nombres() = k
  Next
  
  SelectElement(Nombres(), 5) 
  *Relatif = @Nombres()                             ; l'adresse de l'élément 5
  
  SelectElement(Nombres(), 0)
  MoveElement(Nombres(), #PB_List_After, *Relatif)  ; déplacement après l'élément 5
    
  SelectElement(Nombres(), 10)
  MoveElement(Nombres(), #PB_List_First)            ; déplacement au début
    
  ; Resultat
  ;
  ForEach Nombres()
    Debug Nombres()
  Next

Voir aussi

SwapElements()

OS Supportés

Tous

<- MergeLists() - List Index - NextElement() ->