collection.slice( )

4D v19.8

collection.slice( )


collection.slice ( começarDesde {; fim} ) -> Resultado

Parâmetro	Tipo	Descrição
começarDesde	Inteiro longo	Elemento de início (incluído)
fim	Inteiro longo	índice final (não incluído)
Resultado	Collection	Nova coleção que contém elementos sliced (cópia superficial sem subestruturas)

Descrição

O método collection.slice( ) devolve uma parte de uma coleção em uma nova coleção, selecionada desde o índice começarDesde até o índice fim (fim não incluído). Este método devolve uma cópia superficial da coleção. Se a coleção original for uma coleção compartilhada, a colecção devolvida também é uma coleção compartilhada.

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

A coleção devolvida contém o elemento especificado por começarDesde e todos os elementos posteriores até, mas sem incluir, o elemento especificado por fim.
Se só se especificar o parâmetro começarDesde, a coleção devolvida contém todos os elementos desde começarDesde até o último elemento da coleção original..

Se começarDesde < 0, se volta a calcular como começarDesde :=começarDesde +length (se considera como ponto de inicio do calculo da posição).
Se o valor calculado < 0, começarDesde toma o valor 0.
Se fim < 0, se recalcula como fim:=fim+length.
Se fim < começarDesde (valores passados ou calculados), o método não faz nada.

Exemplo

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

collection.extract( )