New shared collection

4D v20 R7


New shared collection {( valor {; valor2 ; ... ; valorN} )} -> Resultado

Parámetro	Tipo	Descripción
valor		Valor(es) de la colección compartida
Resultado	Collection	Nueva colección compartida

Descripción

El comando New shared collection crea una nueva colección compartida vacía o prellenada y devuelve su referencia. Agregar un elemento a esta colección debe estar rodeado por la estructura Use...End use, de lo contrario, se devuelve un error. Sin embargo, es posible leer un elemento fuera de una estructura Use...End use.

Nota: para más información sobre colecciones compartidas, consulte la página Objetos y colecciones compartidos.

Si no 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 declarada con el comando _O_C_COLLECTION.

Nota: tenga en cuenta que _O_C_COLLECTION declara una variable de tipo Collection, pero no crea una colección.

Opcionalmente, puede llenar previamente la nueva colección compartida pasando uno o varios valores como parámetro(s). De lo contrario, puede agregar o modificar elementos posteriormente a través de la asignación de notación de objeto (ver ejemplo).

Si el índice del nuevo elemento está más allá del último elemento existente de la colección compartida, la colección se redimensionará automáticamente y todos los nuevos elementos intermediarios obtendrán el valor null.

Puede número (real, entero largo...). Los valores numéricos siempre se almacenan como reales.
texto
booleano
fecha
hora (almacenado como número de milisegundos - real)
nulo
objeto compartido(*)
colección compartida(*)

Nota: a diferencia de las colecciones estándar (no compartidas), las colecciones compartidas no admiten imágenes, punteros y objetos o colecciones que no se compartan.

(*)Cuando un objeto compartido o colección se agrega a una colección compartida, comparten el mismo identificador de bloqueo. Para más información sobre este punto, consulte la sección Identificador de bloqueo.

Ejemplo

 $mySharedCol:=New shared collection("alpha";"omega")

 Use($mySharedCol)

    $mySharedCol[1]:="beta"

 End use

Ver también

New collection
New shared object
Objetos y colecciones compartidos