Aller au contenu principal
Version: Next

LIST TO ARRAY

LIST TO ARRAY ( liste ; tableau {; réfEléments} )

ParamètreTypeDescription
listeText, IntegerNom ou référence de la liste de laquelle copier les éléments du premier niveau
tableauArrayTableau dans lequel copier les éléments de la liste
réfElémentsArrayNuméros de référence des éléments de la liste

Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.

Description

La commande LIST TO ARRAY crée ou remplace le tableau tableau avec les éléments du premier niveau de la liste ou de l'énumération liste.

Vous pouvez passer dans le paramètre liste soit un nom d'énumération (une chaîne) soit une référence de liste hiérarchique (RefListe).

Si vous n'avez pas préalablement défini le tableau comme tableau de type Alpha ou Texte, LIST TO ARRAY crée un tableau de type Texte par défaut.

Note : En mode compilé, le tableau doit avoir été préalablement défini et ne peut pas être retypé.

Le paramètre optionnel réfEléments (un tableau de type numérique) retourne les numéros de référence des éléments de la liste.

Vous pouvez utiliser LIST TO ARRAY pour construire un tableau basé sur les éléments de premier niveau d'une liste. Cependant, cette commande ne vous donne pas les moyens de travailler avec les éléments des sous-listes. Pour exploiter pleinement les listes hiérarchiques, il est préférable d'utiliser les commandes de listes hiérarchiques, notamment Load list.

Exemple 1

L'exemple suivant recopie les éléments de l'énumération Régions dans le tableau tabRégions :

 LIST TO ARRAY("Régions";tabRégions)

Exemple 2

Soit une liste hiérarchique créée de la manière suivante :

 MyList2:=New list
 APPEND TO LIST(myList2;"Ecosse";1)
 APPEND TO LIST(myList2;"Angleterre";2)
 APPEND TO LIST(myList2;"Pays de Galles";3)
 myList1:=New list
 APPEND TO LIST(myList1;"France";1)
 APPEND TO LIST(myList1;"Allemagne";2)
 APPEND TO LIST(myList1;"Espagne";3)
 APPEND TO LIST(myList1;"Grande-Bretagne";4;MyList2;True)
 APPEND TO LIST(myList1;"Portugal";5)
 APPEND TO LIST(myList1;"Belgique";6)
 APPEND TO LIST(myList1;"Italie";7)
 APPEND TO LIST(myList1;"Pays-Bas";8)
 APPEND TO LIST(myList1;"Irlande";9)

Cette liste peut être représentée ainsi :

Si vous exécutez l’instruction :

 LIST TO ARRAY(myList1;$MonTab)

...vous obtenez :

 $MonTab{1}="France"
 $MonTab{2}="Allemagne"
 $MonTab{3}="Espagne"
 $MonTab{4}="Grande-Bretagne"
 $MonTab{5}="Portugal"
 ...

Voir aussi

ARRAY TO LIST
Load list
SAVE LIST