jsonAddValueInt (Function)

Top  Previous  Next

Architecture:

NX32L

Device support:

All

Firmware version:

2.10.00


jsonAddValueInt adds the provided integer 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 : DINT

The value to add.

 

Returns: INT

1

- Success.

0

- Function is not supported.

-3

- Invalid handle.

-4

- Not an array

-6

- Not enough resources available to add value.

-99

- Failed to add value

 

 

Declaration:

FUNCTION jsonAddValueInt : INT;
VAR_INPUT
  o     : SYSHANDLE;
  value : DINT;
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;