GetHandle( ) method (JsonArray)

Gets the JSON number value of one or more elements as a HANDLE or HANDLE array.

Return type: HANDLE

Access: PUBLIC

Applies to: Progress.Json.ObjectModel.JsonArray class

Syntax

GetHandle( INPUT index AS INTEGER )

GetHandle( 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 value of the element to be returned. Indexing into JsonArrays is 1-based.

count

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

A JsonError 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 valid JSON integral number

Any element does not fit into an ABL HANDLE