New shared collection

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

Parámetros	Tipo		Descripción
value	Number, Text, Date, Time, Boolean, Shared object, Shared collection	→	Valor(es) de la collection compartida
Resultado	Collection	←	New shared collection

Descripción

El comando New shared collection crea una nueva colección compartida vacía o precargada y devuelve su referencia. Collections can be handled using properties and functions of the Collection class API.

La adición de un elemento a esta colección utilizando el operador de asignación debe estar rodeada por la estructura Use...End use, de lo contrario se genera un error (esto no es necesario cuando se añaden elementos utilizando funciones como push() o map() porque activan automáticamente una estructura interna Use...End use). Sin embargo, es posible leer un elemento sin una estructura Use...End use.

info

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

Si no se pasa ningún parámetro, New shared collection crea una colección compartida vacía y devuelve su referencia.

Debe asignar la referencia devuelta a una variable 4D del tipo Collection.

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

Opcionalmente, puedes precargar la nueva colección compartida pasando uno o varios valor(es) como parámetro(s). De lo contrario, puede añadir o modificar elementos posteriormente por asignación notación objeto (ver ejemplo).

Si el nuevo índice del elemento está más allá del último elemento existente de la colección compartida, la colección se redimensiona automáticamente y a todos los nuevos elementos intermedios se les asigna un valor null.

Puede pasar cualquier número de valores de los siguientes tipos soportados:

• number (real, longint...). Los valores numéricos se almacenan siempre como reales.
• text
• boolean
• date
• time (almacenado como número de milisegundos - real)
• null
• objeto compartido
• colección compartida

nota

Esta función modifica la colección original.

Ejemplo

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

Ver también

New collection
New shared object
Shared objects and shared collections