jsonAddValue (Function)

jsonAddValue adds the provided JSON value to the end of the given JSON array, growing the size of the array by 1.

Input:

o : SYSHANDLE

A handle to the JSON array to add the value to.

value : SYSHANDLE

The value to add.

Returns: INT

Declaration:

FUNCTION jsonAddValue : INT;
VAR_INPUT
  o     : SYSHANDLE;
  value : SYSHANDLE;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
VAR
  rc  : INT;
  arr : SYSHANDLE;
  obj : SYSHANDLE;
END_VAR;
 
BEGIN
  ...
  // Create array
  rc := jsonCreateArray(o := arr);
  // Create object
  rc := jsonCreateObject(o := obj);
  // Add integer to object
  rc := jsonSetValueInt(o := obj, key := "Number", value := 42);
  // Add object to array
  rc := jsonAddValue(o := arr, value := obj);
  // Release object handle
  rc := jsonFree(o := obj);
  ...
END;
 
END_PROGRAM;