collection.remove( )

4D v19.8


collection.remove ( index {; quantos} ) -> Resultado

Parâmetro	Tipo	Descrição
index	Inteiro longo	Elemento no qual vai começar a remoção
quantos	Inteiro longo	Número de elementos a remover, ou 1 elemento se for omitido
Resultado	Collection	Coleção original sem os elementos removidos

Descrição

O método collection.remove( ) elimina um ou mais elementos da posição posicInicial na coleção e devolve a coleção editada.

Nota: este método modifica a coleção original.

Em posicInicial, passe a posição onde deseja que se elimine o elemento da coleção. Advertência: lembre que os elementos da coleção são numerados desde 0. Se posicInicial for maior que a longitude da coleção, a posição inicial real se estabelecerá para a longitude da coleção.

Se posicInicial < 0, retorna a calcular como posicInicial :=posicInicial +longitude (se considera como ponto de partida do cálculo da posição).
Se o valor calculado < 0, posicInicial assume o valor 0.
Se o valor calculado > longitude da coleção, posicInicial toma como valor a longitude da coleção.

Em quantos, passe a quantidade de elementos a eliminar de posicInicial. Se quantos não estiver especificado, então se elimina um elemento.

Se tentar eliminar um elemento de uma coleção vazia, o método não faz nada (não é gerado nenhum erro).

Exemplo

 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 também

collection.clear( )