Saltar al contenido principal
Versión: Siguiente

New shared collection

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

ParámetrosTipoDescripción
valueNumber, Text, Date, Time, Boolean, Shared object, Shared collectionValor(es) de la collection compartida
ResultadoCollectionNew 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.

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). 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