jsonCreateArray (Function)

jsonCreateArray creates a new, empty JSON array.

When the JSON array is no longer needed, it must be released using jsonFree.

Input:

None

Output:

o : SYSHANDLE

A handle to the JSON array.

Returns: INT

Declaration:

FUNCTION jsonCreateArray : INT;
VAR_INPUT
   o     : ACCESS 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);
   // Add integer
   rc := jsonAddValueInt(o := arr, value := 123);
   // Create object
   rc := jsonCreateObject(o := obj);
   // Add integer to object
   rc := jsonSetValueInt(o := obj, key := "Number", value := 42);
   // Replace integer in array with object
   rc := jsonSetValue(o := arr, idx := 0, value := obj);
   // Release object handle
   rc := jsonFree(o := obj);
   ...
END;
 
END_PROGRAM;