collection.push( )

4D v19.8

collection.push( )


collection.push ( elemento {; elemento2 ; ... ; elementoN} ) -> Resultado

Parâmetro	Tipo	Descrição
elemento	Expression	Elementos a adicionar à coleção
Resultado	Collection	Coleção original que contém os elementos adicionados

Descrição

A função collection.push( ) agrega um ou mais elemento(s) ao final da instância de coleção e devolve a coleção editada.

Nota: este comando modifica a coleção original.

Exemplo 1

 C_COLLECTION($col)

 $col:=New collection(1;2) //$col=[1,2]

 $col.push(3) //$col=[1,2,3]

 $col.push(6;New object("firstname";"John";"lastname";"Smith"))

  //$col=[1,2,3,6,{firstname:John,lastname:Smith}

Exemplo 2

Se quiser ordenar a coleção resultante:

 C_COLLECTION($col;$sortedCol)

 $col:=New collection(5;3;9) //$col=[5,3,9]

 $sortedCol:=$col.push(7;50).sort()

  //$col=[5,3,9,7,50]

  //$sortedCol=[3,5,7,9,50]

Ver também

collection.pop( )
collection.shift( )