New shared collection

New shared collection {( ...value : any )} : Collection

Paramètres	Type		Description
value	Number, Text, Date, Time, Boolean, Shared object, Shared collection	→	Valeur(s) de la collection partagée
Résultat	Collection	←	New shared collection

Description

La commande New shared collection crée une nouvelle collection partagée vide ou préremplie et retourne sa référence. Collections can be handled using properties and functions of the Collection class API.

Adding an element to this collection using the assignment operator must be surrounded by the Use...End use structure, otherwise an error is generated (this is not necessary when adding elements using functions such as push() or map() because they automatically trigger an internal Use...End use). La lecture d'un élément sans structure Use...End use est cependant possible.

info

For more information on shared collections, please refer to the Shared objects and collections page.

Si vous ne passez aucun paramètre, New shared collection crée une collection vide et retourne sa référence.

Vous devez affecter la référence retournée à une variable 4D de type Collection.

Keep in mind that var : Collection statement declares a variable of the Collection type but does not create any collection.

Optionnellement, vous pouvez préremplir la nouvelle collection partagée en passant une ou plusieurs value(s) comme paramètre(s). Sinon, vous pouvez ajouter ou modifier des éléments ultérieurement via l'assignation en notation objet (cf. exemple).

Si l'indice du nouvel élément est au-delà du dernier élément existant de la collection partagée, la collection est automatiquement redimensionnée et tous les nouveaux éléments intermédiaires reçoivent la valeur null.

Vous pouvez passer tout nombre de valeurs de n'importe quel type pris en charge :

• nombre (réel, entier...). Les valeurs numériques sont toujours stockées sous forme de réels.
• text
• boolean
• date
• heure (stockée en nombre de milliseconds - réel)
• Null
• Si vous souhaitez que l'évaluation soit sensible à la casse ou pour différencier des caractères accentués, passez la constante ck diacritical dans le paramètre option.
• $1.stop (booléen, optionnel) : true pour stopper le rétroappel de la méthode.

note

Contrairement aux collections standard (non partagées), les collections partagées ne prennent pas en charge les images, les pointeurs et les objets ou collections non partagés.

Exemple

 $mySharedCol:=New shared collection("alpha";"omega")
 Use($mySharedCol)
    $mySharedCol[1]:="beta"
 End use

Voir également

New collection
New shared object
Shared objects and shared collections