4D v19

collection.insert( )

Inicio

 
4D v19
collection.insert( )

collection.insert( )  


 

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 

 
ARTICLE USAGE

Manual de lenguaje 4D ( 4D v19)
Manual de lenguaje 4D ( 4D v19.1)