4D v16.3
ARRAY TO LIST
- 4D - Langage
-
- Tableaux
-
- Présentation des tableaux
- Créer des tableaux
- Tableaux et objets de formulaire
- Les tableaux et le langage 4D
- Tableaux et pointeurs
- Utiliser l'élément zéro d'un tableau
- Tableaux à deux dimensions
- Tableaux et mémoire
- APPEND TO ARRAY
- ARRAY BLOB
- ARRAY BOOLEAN
- ARRAY DATE
- ARRAY INTEGER
- ARRAY LONGINT
- ARRAY OBJECT
- ARRAY PICTURE
- ARRAY POINTER
- ARRAY REAL
- ARRAY TEXT
- ARRAY TIME
- ARRAY TO LIST
- ARRAY TO SELECTION
- BOOLEAN ARRAY FROM SET
- COPY ARRAY
- Count in array
- DELETE FROM ARRAY
- DISTINCT ATTRIBUTE PATHSNew
- DISTINCT ATTRIBUTE VALUESNew
- DISTINCT VALUES
- Find in array
- Find in sorted array
- INSERT IN ARRAY
- LIST TO ARRAY
- LONGINT ARRAY FROM SELECTION
- MULTI SORT ARRAY
- SELECTION RANGE TO ARRAY
- SELECTION TO ARRAY
- Size of array
- SORT ARRAY
- TEXT TO ARRAY
- _o_ARRAY STRING
ARRAY TO LIST
| ARRAY TO LIST ( tableau ; liste {; réfEléments} ) | ||||||||
| Paramètre | Type | Description | ||||||
| tableau | Tableau |
|
Tableau duquel copier les éléments | |||||
| liste | Chaîne, RefListe |
|
Nom ou référence de la liste dans laquelle copier les éléments du tableau | |||||
| réfEléments | Tableau |
|
Tableau numérique des numéros de référence des éléments | |||||
La commande ARRAY TO LIST crée ou remplace la liste hiérarchique ou l'énumération liste en utilisant les éléments du tableau tableau.
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). Dans ce deuxième cas, la liste doit déjà avoir été créée (par exemple via la commande New list) pour que la commande fonctionne.
Le paramètre optionnel réfEléments, s'il est passé, doit être un tableau de type numérique synchronisé avec le tableau tableau. Chaque élément de ce tableau indique le numéro de référence de l'élément de la liste correspondant dans tableau. Si ce paramètre est omis, 4D affecte automatiquement aux éléments de la liste les numéros de référence 1, 2... N.
Note de compatibilité : La commande ARRAY TO LIST doit être utilisée avec précaution du fait des limitations suivantes :
- cette commande permet de définir seulement les éléments du premier niveau de la liste.
- lorsque vous l'utilisez avec une énumération, cette commande modifie la structure de l'application (les énumérations sont stockées dans le fichier de structure), les modifications effectuées en local seront donc perdues lors de mise à jour du fichier de structure en production.
- cette commande ne peut pas être utilisée dans un composant avec une énumération car les composants sont chargés avec la structure en lecture seulement.
Vous pouvez utiliser ARRAY TO LIST pour construire une liste basée sur les éléments d'un tableau. Cependant, pour vous affranchir de ces contraintes et exploiter pleinement les listes de valeurs, il est conseillé d'utiliser les commandes du thème Listes hiérarchiques.
L'exemple suivant copie le tableau tabRégions dans l'énumération "Régions" :
ARRAY TO LIST(tabRégions;"Régions")Vous souhaitez placer les valeurs distinctes d’un champ dans une liste, par exemple pour créer un pop up menu hiérarchique. Vous pouvez écrire :
ALL RECORDS([Company])
DISTINCT VALUES([Company]country;$tabPays)
listePays:=New list
ARRAY TO LIST($tabPays;listePays)La commande ARRAY TO LIST génère l'erreur -9957 lorsqu'elle est appliquée à une énumération en cours de modification en mode Développement. Vous pouvez intercepter cette erreur à l'aide d'une méthode projet de gestion des erreurs installée par la commande ON ERR CALL.
Produit : 4D
Thème : Tableaux
Numéro :
287
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)
