collection.push( )

Home

4D v18

collection.push( )

Description

The collection.push( ) method appends one or more element(s) to the end of the collection instance and returns the edited collection.

Note: This method modifies the original collection.

Example 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}

Example 2

You want to sort the resutling collection:

 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]