4D Doc Center : OB SET ARRAY

4D v14.3

OB SET ARRAY


OB SET ARRAY ( object ; property ; array )

引数	型	説明
object	Object	構造化されたオブジェクト
property	テキスト	設定したいプロパティ名
array	テキスト配列, 実数配列, ブール配列, Object array, ポインター配列, 倍長整数配列	プロパティに保存したい配列

説明

OB SET ARRAYコマンドは、 object 引数で指定したランゲージオブジェクトの中の property と関連付ける配列 array を定義します。

object で指定するオブジェクトは、 C_OBJECT コマンドを使用して作成されている必要があります。

property 引数には、作成または修正したいプロパティのラベル(名前)を渡して下さい。オブジェクト内に指定されたプロパティが存在する場合、その値は指定した値で上書きされます。プロパティが存在しない場合、新たにプロパティが作成されます。
property 引数では、大文字と小文字は区別されることに注意して下さい。

array 引数には、プロパティの値として関連付けたい配列を渡して下さい。渡せる配列の型としては複数の型がサポートされています。

注: 二次元配列を使用することはできません。

例題 1

テキスト配列を使用する場合:

 C_OBJECT($Children)

 ARRAY TEXT($arrChildren;3)

 $arrChildren{1}:="Richard"

 $arrChildren{2}:="Susan"

 $arrChildren{3}:="James"

 

 OB SET ARRAY($Children;"Children";$arrChildren)

  // Value of $Children = {"Children":["Richard","Susan","James"]}

例題 2

配列に要素を追加する場合:

 ARRAY TEXT($arrText;2)

 $arrText{1}:="Smith"

 $arrText{2}:="White"

 C_OBJECT($Employees)

 OB SET ARRAY($Employees;"Employees";$arrText)

 APPEND TO ARRAY($arrText;"Brown") // Add to the 4D array

  // $Employees = {"Employees":["Smith","White"]}

 

 OB SET ARRAY($Employees;"Employees";$arrText)

  // $Employees = {"Employees":["Smith","White","Brown"]}

例題 3

テキスト配列の一要素を配列として使用する場合:

  // $Employees = {"Employees":["Smith","White","Brown"]}

 OB SET ARRAY($Employees ;"Manager";$arrText{1})

  // $Employees = {"Employees":["Smith","White","Brown"],"Manager":["Smith"]}

例題 4

オブジェクト配列を使用する場合:

 C_OBJECT($Children;$ref_richard;$ref_susan;$ref_james)

 ARRAY OBJECT($arrChildren;0)

 OB SET($ref_richard;"nom";"Richard";"age";7)

 APPEND TO ARRAY($arrChildren;$ref_richard)

 OB SET($ref_susan;"name";"Susan";"age";4)

 APPEND TO ARRAY($arrChildren;$ref_susan)

 OB SET($ref_james;"name";"James";"age";3)

 

 APPEND TO ARRAY($arrChildren;$ref_james)

 

  // $arrChildren {1} = {"name":"Richard","age":7}

  // $arrChildren {2} = {"name":"Susan","age":4}

  // $arrChildren {3} = {"name":"James","age":3}

 

 OB SET ARRAY($Children;"Children";$arrChildren)

 

  // $Children = {"Children":[{"name":"Richard","age":7},{"name":"Susan",

  // "age":4},{"name":"James","age":3}]}

オブジェクトはデバッガ内では以下の様に表示されます: