collection.combine( )

4D v19.8


collection.combine ( col2 {; index} ) -> Resultado

Parámetro	Tipo	Descripción
col2	Collection	Colección a combinar
index	Entero largo	Posición a la que insertar elementos para combinar en la colección (por defecto=longitud+1)
Resultado	Collection	Colección original que contiene elemento(s) combinado(s)

Descripción

El método collection.combine( ) inserta elementos col2 al final o en la posición index especificada en la instancia de colección y devuelve la colección editada. A diferencia del método collection.insert( ), collection.combine( ) agrega cada valor de col2 en la colección original y no como un único elemento de colección.

Nota: este método modifica la colección original.

Por defecto, los elementos col2 se agregan al final de la colección original. Puede pasar en index la posición donde desea insertar los elementos de col2 en la colección. Advertencia: tenga en cuenta que los elementos de la colección están numerados desde 0.

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

Ejemplo

 C_COLLECTION($c;$fruits)

 $c:=New collection(1;2;3;4;5;6)

 $fruits:=New collection("Orange";"Banana";"Apple";"Grape")

 $c.combine($fruits;3) //[1,2,3,"Orange","Banana","Apple","Grape",4,5,6]

Ver también

collection.concat( )
collection.insert( )