collection.slice( )

4D v19.8

collection.slice( )


collection.slice ( comenzarDesde {; fin} ) -> Resultado

Parámetro	Tipo	Descripción
comenzarDesde	Entero largo	Índice de inicio (incluido)
fin	Entero largo	Índice de fin (no incluido)
Resultado	Collection	Nueva colección que contiene elementos cortados (copia superficial)

Descripción

El método collection.slice( ) devuelve una parte de una colección en una nueva colección, seleccionada desde el índice comenzarDesde hasta el índice fin (fin no incluido). Este método devuelve una copia superficial de la colección. Si la colección original es una colección compartida, la colección devuelta también es una colección compartida.

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

La colección devuelta contiene el elemento especificado por comenzarDesde y todos los elementos posteriores hasta, pero sin incluir, el elemento especificado por fin.
Si solo se especifica el parámetro comenzarDesde, la colección devuelta contiene todos los elementos desde comenzarDesde hasta el último elemento de la colección original..

Si comenzarDesde < 0, se vuelve a calcular como comenzarDesde :=comenzarDesde +length (se considera como punto de inicio del calculo de la posición).
Si el valor calculado < 0, comenzarDesde toma el valor 0.
Si fin < 0, se recalcula como fin:=fin+length.
Si fin < comenzarDesde (valores pasados o calculados), el método no hace nada.

Ejemplo

 C_COLLECTION($c;$nc)

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

 $nc:=$c.slice(0;3) //$nc=[1,2,3]

 $nc:=$c.slice(3) //$nc=[4,5]

 $nc:=$c.slice(1;-1) //$nc=[2,3,4]

 $nc:=$c.slice(-3;-2) //$nc=[3]

Ver también

collection.extract( )