collection.fill( )

4D v19.8

collection.fill( )


collection.fill ( valor {; posicInic {; fim}} ) -> Resultado

Parâmetro	Tipo	Descrição
valor	Número, Texto, Collection, Objeto, Data, Booleano	Valor a preencher
posicInic	Inteiro longo	índice inicial (incluído)
fim	Inteiro longo	Índice fim (não incluído)
Resultado	Collection	Coleção original com valores preenchidos

Descrição

O método collection.fill( ) preenche os elementos da coleção com o valor especificado, opcionalmente desde posicIni a fim e devolve a coleção resultante.

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

Se o parâmetro posicIni for omitido, valor se aplica a todos os elementos de coleção (posicIni =0). Se for omitido o parâmetro fim, o valor se estabelece no último elemento da coleção (fim =length).
Se posicIni < 0, se recalcula como posicIni :=posicIni +length (se considera como o deslocamento desde o final da coleção). Se o valor calculado for negativo, posicIni toma o valor 0.
Se fim < 0 , se recalcula como fin :=fin +length.
Se fim d < posicIni (valores passados ou calculados), o método não faz nada.

Exemplo

 C_COLLECTION($c)

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

 $c.fill("2") // $c:=[2,2,2,2,2,2,2,2]

 $c.fill("Hello";5) // $c=[2,2,2,2,2,Hello,Hello,Hello]

 $c.fill(0;1;5) // $c=[2,0,0,0,0,Hello,Hello,Hello]

 $c.fill("world";1;-5) //-5+8=3 -> $c=[2,"world","world",0,0,Hello,Hello,Hello]

Ver também

collection.resize( )