collection.push( )

4D v19.8

collection.push( )


collection.push ( element {; element2 ; ... ; elementN} ) -> 戻り値

引数	型	説明
element	式	コレクションに追加する要素
戻り値	コレクション	追加された要素を含む、元のコレクション

説明

collection.push( ) ファンクションは、element 引数で指定した1つまたはそれ以上の要素をコレクションインスタンスの最後に追加し、編集されたコレクションを返します。

注: このコマンドは、元のコレクションを編集します。

例題 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}

例題 2

返されるコレクションを並び替えしたい場合を考えます:

 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]

参照

collection.pop( )
collection.shift( )