TABLEAU VERS COLLECTION

4D v20 R7


TABLEAU VERS COLLECTION ( collection ; tableau {; nomPropriété}{; tableau2 ; nomPropriété2 ; ... ; tableauN ; nomPropriétéN} )

Paramètre	Type	Description
collection	Collection	Collection qui reçoit les données du tableau
tableau	Tableau	Tableau à copier vers la collection ; si le paramètre nomPropriété est passé, sont copiées les valeurs correspondantes à la propriété dans la collection
nomPropriété	Texte	Nom de propriété Objet dont les valeurs remplissent les éléments du tableau

Description

La commande TABLEAU VERS COLLECTION copie un ou plusieurs tableau(x) dans les éléments ou les valeurs nomPropriété de collection.

Cette commande peut être utilisée avec une collection qui contient des valeurs ou une collection qui contient des objets, dans ce cas le(s) paramètre(s) nomPropriété est (sont) obligatoire(s).

Si vous omettez le paramètre nomPropriété, la commande copie tous les éléments du tableau vers la collection. Si la collection n'était pas vide, les éléments existants sont remplacés et de nouveaux éléments sont ajoutés si la taille du tableau est plus grande que la longueur de la collection. Après l'exécution de cette commande, la longueur de la collection est identique à la taille du tableau.
Si vous passez un ou plusieurs paramètres nomPropriété(s), la commande crée ou remplace les éléments de la collection avec des objets. Chaque objet est construit avec une propriété dont le nom est fourni dans le paramètre nomPropriété, et dont la valeur est l'élément de tableau correspondant. Si la collection n'était pas vide, les éléments existants sont remplacés et de nouveaux éléments sont ajoutés si la taille du tableau était plus grande que la collection. Aprés l'exécution de la commande, la longueur de la collection est identique à la celle du tableau le plus grand.

Exemple 1

Vous souhaitez copier un tableau texte dans une collection :

 C_COLLECTION($colFruits)

 $colFruits:=Creer collection

 TABLEAU TEXTE($artFruits;4)

 $artFruits{1}:="Orange"

 $artFruits{2}:="Banana"

 $artFruits{3}:="Apple"

 $artFruits{4}:="Grape"

 TABLEAU VERS COLLECTION($colFruits;$artFruits)

  //$colFruits[0]="Orange"

  //$colFruits[1]="Banana"

  //...

Exemple 2

Vous souhaitez copier les valeurs de champs dans une collection d'objets via des tableaux :

 C_COLLECTION($col)

 $col:=Creer collection

 TABLEAU TEXTE($artCity;0)

 TABLEAU ENTIER LONG($arLZipCode;0)

 SELECTION VERS TABLEAU([Customer]City;$artCity)

 SELECTION VERS TABLEAU([Customer]Zipcode;$arLZipCode)

 TABLEAU VERS COLLECTION($col;$artCity;"cityName";$arLZipCode;"Zip")

  //$col[0]={"cityName":"Cleveland","Zip":35049}

  //$col[1]={"cityName":"Blountsville","Zip":35031}

  //...

Exemple 3

Vous souhaiter copier un tableau texte dans une collection partagée :

 TABLEAU TEXTE($at;1)

 

 AJOUTER A TABLEAU($at;"Apple")

 AJOUTER A TABLEAU($at;"Orange")

 AJOUTER A TABLEAU($at;"Grape")

 

 C_COLLECTION($sharedCol)

 $sharedCol:=Creer collection partagee

 

 Utiliser($sharedCol)

    TABLEAU VERS COLLECTION($sharedCol;$at)

 Fin utiliser

Voir aussi

COLLECTION VERS TABLEAU
Conversions de type entre les collections et les tableaux 4D