4D v16.3LISTE VERS TABLEAU |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16.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 | |||||
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.
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 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.
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)
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"
...
Produit : 4D
Thème : Tableaux
Numéro :
288
Nom intl. : LIST TO ARRAY
Créé : < 4D v6
Modifié : 4D v14
4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)