util.JSON.parse

Syntax

util.JSON.parse(
     s STRING,
     variableRef { primitive-type
                 | record-type
                 | array-type
                 | dictionary-type
                 }
   )

1. s is a string value that contains JSON formatted data.
2. variableRef is the variable to be initialized with values of the JSON string.
   Important: The variableRef parameter is passed by reference to the method.
3. primitive-type is a primitive data type of Genero (INTEGER, DATE, VARCHAR)
4. record-type is a RECORD ... END RECORD type.
5. array-type is a DYNAMIC ARRAY OF ... or ARRAY[n] OF ... type.
6. dictionary-type is a DICTIONARY OF ... type.

Usage

The util.JSON.parse() class method scans the JSON source string passed as parameter and fills the destination variable members by name.

If the provided string is not valid JSON, the parse() method will raise error -8109. Consider enclosing the parse() method call in a TRY/CATCH block, if the source string can be malformed JSON.

The destination variable is expected to have the same structure as the JSON source data, it can be a RECORD, DYNAMIC ARRAY or a DICTIONARY.

The parse() method initializes the target variable to NULL before the parsing starts.

See JSON support for details on how the destination variable is populated when the structures are not identical.