collection.remove( )

4D v19.8


collection.remove ( posicIni {; cuantos} ) -> Resultado

Parámetro	Tipo	Descripción
posicIni	Entero largo	Elemento en el que comenzar la eliminación
cuantos	Entero largo	Cantidad de elementos a eliminar, o 1 elemento si se omite
Resultado	Collection	Colección original sin elemento(s) eliminado(s)

Descripción

El método collection.remove( ) elimina uno o más elementos de la posición posicInicial en la colección y devuelve la colección editada.

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

En posicInicial, pase la posición donde desea que se elimine el elemento de la colección. Advertencia: tenga en cuenta que los elementos de la colección se numeran desde 0. Si posicInicial es mayor que la longitud de la colección, la posición inicial real se establecerá para la longitud de la colección.

Si posicInicial < 0, se vuelve a calcular como posicInicial :=posicInicial +longitud (se considera como punto de partida del calculo de la posición).
Si el valor calculado < 0, posicInicial toma el valor 0.
Si el valor calculado > longitud de la colección, posicInicial toma como valor la longitud de la colección.

En cuantos, pase la cantidad de elementos a eliminar de posicInicial. Si cuantos no está especificado, entonces se elimina un elemento.

Si intenta eliminar un elemento de una colección vacía, el método no hace nada (no se genera ningún error).

Ejemplo

 C_COLLECTION($col)

 $col:=New collection("a";"b";"c";"d";"e";"f";"g";"h")

 $col.remove(3) // $col=["a","b","c","e","f","g","h"]

 $col.remove(3;2) // $col=["a","b","c","g","h"]

 $col.remove(-8;1) // $col=["b","c","g","h"]

 $col.remove(-3;1) // $col=["b","g","h"]

Ver también

collection.clear( )