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