Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter ElevenSGML Functions (continued)

SGMLNextItem Function

Overview

The SGMLNextItem function parses the incoming data and returns a tag, space, a character entity or a PCDATA word from the next parse position or a specified location.

Syntax/Parameters

Syntax

string = SGMLNextItem ( handle hSGML, [int x, int y] );

Parameters

hSGML

A handle to an SGML object.

x

An optional int value specifying the zero-based X position to parse from. The position is native. When provided, the Y position must also be provided. If omitted, the function parses from the current position.

y

An optional int value specifying the zero-based Y position to parse from. The X position must be provided with this parameter.

Return Value

A string containing the tag’s text, an empty string on error. Use the GetLastError function to retrieve an error code.

Remarks

The total size of a tag’s data is limited to 4,096 bytes and the total size of an item cannot exceed 1,048,575 bytes. In the event of an overflow, an error condition will be set and the coordinates set for the complete item so it can be manually parsed or loaded.

Each item parsed sets the statistics for the item such as the type and its end points. For elements, the element attributes/properties are parsed and loaded into the SGML Object.

Related Functions

Platform Support

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

Legato IDE, Legato Basic