Este es el sitio web histórico de la documentación de 4D. La documentación se está trasladando progresivamente a developer.4d.com

Inicio

 
4D v19.8
collection.insert( )

collection.insert( ) 


 

collection.insert ( indice ; elemento ) -> coleccion 
Parámetro Tipo   Descripción
indice  Entero largo in Donde insertar el elemento
elemento  Expresión in Elemento a insertar en la colección
coleccion  Collection in Colección original que contiene el elemento insertado

La función collection.insert( ) inserta el elemento en la posición de indice especificada en la instancia de colección y devuelve la colección editada.

Nota: este comando modifica la colección original.

En indice, pase la posición donde desea insertar el elemento en la colección.

Atención: tenga en cuenta que los elementos de la colección están numerados desde 0.

  • Si indice > la longitud de la colección, el índice de inicio real se establecerá en la longitud de la colección.
  • Si indice <0, se vuelve a calcular como indice:=indice+longitud  (se considera como el desplazamiento desde el final de la colección).
  • Si el valor calculado es negativo, indice se establece en 0.

Se puede insertar cualquier tipo de elemento aceptado por una colección, incluso otra colección.

Ejemplo  

 C_COLLECTION($col)
 $col:=New collection("a";"b";"c";"d") //$col=["a","b","c","d"]
 $col.insert(2;"X") //$col=["a","b","X","c","d"]
 $col.insert(-2;"Y") //$col=["a","b","X","Y","c","d"]
 $col.insert(-10;"Hi") //$col=["Hi","a","b","X","Y","c","d"]



Ver también 

collection.combine( )

 
PROPIEDADES 

Producto: 4D
Tema: Colecciones

 
CONTENIDO DE LA PÁGINA 
 
HISTORIA 

Creado por: 4D v16 R6

 
ARTICLE USAGE

Manual de lenguaje 4D ( 4D v19)
Manual de lenguaje 4D ( 4D v19.1)
Manual de lenguaje 4D ( 4D v19.4)
Manual de lenguaje 4D ( 4D v19.5)
Manual de lenguaje 4D ( 4D v19.6)
Manual de lenguaje 4D ( 4D v19.7)
Manual de lenguaje 4D ( 4D v19.8)