4D Doc Center : LISTE VERS TABLEAU

4D v14.3

LISTE VERS TABLEAU


LISTE VERS TABLEAU ( liste ; tableau {; réfEléments} )

Paramètre	Type	Description
liste	Chaîne, RefListe	Nom ou référence de la liste de laquelle copier les éléments du premier niveau
tableau	Tableau	Tableau dans lequel copier les éléments de la liste
réfEléments	Tableau	Numéros de référence des éléments de la liste

Description

La commande LISTE VERS TABLEAU 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, LISTE VERS TABLEAU crée un tableau de type Texte par défaut.

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 LISTE VERS TABLEAU 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 Charger liste.

Exemple 1

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

LISTE VERS TABLEAU("Régions";tabRégions)

Exemple 2

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

 MyList2:=Nouvelle liste

 AJOUTER A LISTE(myList2;"Ecosse";1)

 AJOUTER A LISTE(myList2;"Angleterre";2)

 AJOUTER A LISTE(myList2;"Pays de Galles";3)

 myList1:=Nouvelle liste

 AJOUTER A LISTE(myList1;"France";1)

 AJOUTER A LISTE(myList1;"Allemagne";2)

 AJOUTER A LISTE(myList1;"Espagne";3)

 AJOUTER A LISTE(myList1;"Grande-Bretagne";4;MyList2;Vrai)

 AJOUTER A LISTE(myList1;"Portugal";5)

 AJOUTER A LISTE(myList1;"Belgique";6)

 AJOUTER A LISTE(myList1;"Italie";7)

 AJOUTER A LISTE(myList1;"Pays-Bas";8)

 AJOUTER A LISTE(myList1;"Irlande";9)

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

Si vous exécutez l’instruction :

LISTE VERS TABLEAU(myList1;$MonTab)

...vous obtenez :

 $MonTab{1}="France"

 $MonTab{2}="Allemagne"

 $MonTab{3}="Espagne"

 $MonTab{4}="Grande-Bretagne"

 $MonTab{5}="Portugal"

 ...