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;