4D Doc Center : OB GET PROPERTY NAMES

4D v14.3

OB GET PROPERTY NAMES


OB GET PROPERTY NAMES ( object ; arrProperties {; arrTypes} )

引数	型	説明
object	Object	構造化されたオブジェクト
arrProperties	テキスト配列	プロパティ名
arrTypes	倍長整数配列	プロパティの型

説明

OB GET PROPERTY NAMESコマンドは、 object 引数で指定したランゲージオブジェクトの中に含まれているプロパティの名前を、 arrProperties という名前のテキスト配列に入れて返します。

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

arrProperties 引数にはテキスト配列を渡します。配列が存在しない場合、コマンドが自動的に作成してリサイズします。

また、任意の arrTypes 引数に倍長整数配列を渡すこともできます。この場合、 arrProperties 内の個々の要素に関して、プロパティに保存された値の型を arrTypes に返します。返される値は、 "Field and Variable Types" テーマ内にある以下の定数のどれかになります:

定数	型	値
Is Boolean	倍長整数	6
Is JSON null	倍長整数	255
Is object	倍長整数	38
Is real	倍長整数	1
Is string var	倍長整数	24
Is text	倍長整数	2
Is undefined	倍長整数	5
Object array	倍長整数	39

例題 1

オブジェクトが空でないかどうかをテストしたい場合を考えます:

 ARRAY TEXT(arrNames;0)

 ARRAY LONGINT(arrTypes;0)

 C_OBJECT($ref_richard)

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

 OB GET PROPERTY NAMES($ref_richard;arrNames;arrTypes)

  // arrNames{1}="name", arrNames{2}="age"

  // arrTypes{1}=2, arrTypes{2}=1

 If(Size of array(arrNames)#0)

  // ...

 End if

例題 2

オブジェクト配列の要素を使用する場合を考えます:

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

 ARRAY OBJECT($arrayChildren;0)

 

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

 APPEND TO ARRAY($arrayChildren;$ref_richard)

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

 APPEND TO ARRAY($arrayChildren;$ref_susan)

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

 APPEND TO ARRAY($arrayChildren;$ref_james)

 

 OB GET PROPERTY NAMES($arrayChildren{1};$arrNames;$arrTypes)