4D v17.4

collection.slice( )

Página Inicial

 
4D v17.4
collection.slice( )

collection.slice( )  


 

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( )

 
PROPRIEDADES 

Produto: 4D
Tema: Coleções

This command can be run in preemptive processes

 
CONTEÚDO DA PÁGINA 
 
HISTÓRIA 

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v17)
Manual de linguagem 4D ( 4D v17.1)
Manual de linguagem 4D ( 4D v17.2)
Manual de linguagem 4D ( 4D v17.3)
Manual de linguagem 4D ( 4D v17.4)