GetCharacter( ) method (JsonArray)

Gets the JSON string value of one or more elements as a CHARACTER or CHARACTER array.

To get the string value of other JSON data types as a string, use the GetJsonText( ) method.

Return type: CHARACTER

Access: PUBLIC

Applies to: Progress.Json.ObjectModel.JsonArray class

Syntax

GetCharacter( INPUT index AS INTEGER )

GetCharacter( INPUT index AS INTEGER,
                     INPUT count AS INTEGER )

When this method is called with one parameter, the value of a single element is returned. Using two parameters directs the AVM to return an ABL array consisting of count elements.

index

An INTEGER identifying the value of the element to be returned. Indexing into a JsonArrays is 1-based.

count

An INTEGER specifying the number of elements, starting with the element at index, to be returned to the ABL array.

A JSON error is raised if :

• index is less than 1, is greater than the length of the JsonArray, or is the Unknown value (?)
• count is less than 1 or is the Unknown value (?)
• The sum of index and count is greater than the length of the JsonArray
• Any element is not a JSON string