4D v14.3

OB SET ARRAY

Página Inicial

 
4D v14.3
OB SET ARRAY

OB SET ARRAY 


 

OB SET ARRAY ( objeto ; propriedade ; array ) 
Parâmetro Tipo   Descrição
objeto  Object in Objeto estruturado
propriedade  Texto in Nome da propriedade a definir
array  Array texto, Array real, Array booleano, Object array, Array ponteiro, Array inteiro longo in Array a armazenar em propriedade

O comando OB SET ARRAY define o array a ser associado a propriedade no objeto definido pelo parâmetro objeto.

objeto deve ter sido definido com o comando C_OBJECT.

No parâmetro propriedade, passe a etiqueta da propriedade a criar ou modificar. Se a propriedade já existe em objeto, seu valor se atualiza. Se não existe, é criado.
Tenha em conta que o parâmetro propriedade leva em conta as maiúsculas e minúsculas.

No parâmetro array, passe o array que deve passar como valor da propriedade. Se admitem vários tipos de array.

Nota: não é possível utilizar arrays de duas dimensões.

Utilizando um array texto:

 C_OBJECT($Children)
 ARRAY TEXT($arrChildren;3)
 $arrChildren{1}:="Richard"
 $arrChildren{2}:="Susan"
 $arrChildren{3}:="James"
 
 OB SET ARRAY($Children;"Children";$arrChildren)
  // Valor de $Children = {"Children":["Richard","Susan","James"]}

Adição de um elemento de um array:

 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"]}

Utilizando um array texto com seleção de um elemento:

  // $Employees = {"Employees":["Smith","White","Brown"]}
 OB SET ARRAY($Employees ;"Manager";$arrText{1})
  // $Employees = {"Employees":["Smith","White","Brown"],"Manager":["Smith"]}

Uso de um array objeto:

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

Assim é como o objeto aparece no depurador:

 
PROPRIEDADES 

Produto: 4D
Tema: Objetos (Linguagem)
Número 1227

 
HISTÓRIA 

New
Criado por: 4D v14

 
VER TAMBÉM 

OB GET ARRAY
OB SET

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)