Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter EightData Functions (continued)

JSONGetObjectIndex Function

Overview

The JSONGetObjectIndex function locates a specific object and returns the index to that object.

Syntax/Parameters

Syntax

int = JSONGetObjectIndex ( handle hJSON, string item, [params ...] );

Parameters

hJSON

A string representing

item

A string representing the item to capture from the object. The string can be a formatted string.

params

An optional series of parameters that can be applied to the formatted string.

Return Value

Returns an int as a zero-based object index or -1 on error. Use the GetLastError and GetLastErrorMessage functions to retrieve additional error information.

On success, the last error value will contain the type of object located.

Remarks

The JSONGetObjectIndex function retrieves data associated with a specific node within the object. The node is “obj.name.name...” where “obj” is the root and the names are the specified location in the object.

The item and params parameters can be combined to create a formatted print string. For more information on formatted strings, see Section 5.2 String Functions.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic