GetCOMHandle( ) method (JsonArray)

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

Return type: COM-HANDLE

Access: PUBLIC

Applies to: Progress.Json.ObjectModel.JsonArray class

Syntax

GetCOMHandle( INPUT index AS INTEGER )

GetCOMHandle( 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 JsonArrays is 1-based.

count

An INTEGER specifying the number of elements, starting with the element at index, to be returned to 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 a COM-HANDLE