OB SET ARRAY
OB SET ARRAY ( object ; property ; array )
Parameter | Type | Description | |
---|---|---|---|
object | Object, Object | → | Structured object |
property | Text | → | Name of property to set |
array | Array, Variable | → | Array to store in property |
Description
The OB SET ARRAY command defines the array to be associated with the property in the language object designated by the object parameter.can be an object varialble or a 4D object field.
In the property parameter, pass the label of the property to be created or modified. If the property already exists in object, its value is updated. If it does not exist, it is created.
Note that the property parameter is case sensitive.
In the array parameter, pass the array that must be passed as the property value. Several array types are supported: real, longint, text, boolean, object, pointer, or picture.
Notes:
- Simple variables are supported in the array parameter, in which case a single-value array is created and associated to the property.
- It is not possible to use two-dimensional arrays.
Example 1
Using a text array:
var $Children : Object
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"]}
Example 2
Adding an element to an array:
ARRAY TEXT($arrText;2)
$arrText{1}:="Smith"
$arrText{2}:="White"
var $Employees : Object
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"]}
Example 3
Using a text array with selection of an element:
// $Employees = {"Employees":["Smith","White","Brown"]}
OB SET ARRAY($Employees ;"Manager";$arrText{1})
// $Employees = {"Employees":["Smith","White","Brown"],"Manager":["Smith"]}
Example 4
Using an object array:
var $Children;$ref_richard;$ref_susan;$ref_james : Object
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}]}
Here is how the object appears in the debugger:
Example 5
Using an Object field:
ARRAY TEXT($arrGirls;3)
$arrGirls{1}:="Emma"
$arrGirls{2}:="Susan"
$arrGirls{3}:="Jamie"
OB SET ARRAY([People]Children;"Girls";$arrGirls)
Example 6
Using a picture array:
ARRAY PICTURE($arrPhotos;3)
READ PICTURE FILE("pict1.jpg";$arrPhotos{1})
READ PICTURE FILE("pict2.jpg";$arrPhotos{2})
READ PICTURE FILE("pict3.jpg";$arrPhotos{3})
OB SET ARRAY([Cities]Places;"Photoset";$arrPhotos)
See also
OB GET ARRAY
OB SET
Type conversions between collections and 4D arrays
Properties
Command number | 1227 |
Thread safe | ✓ |