  |
GoFiler Legato Script Reference
Legato v 1.4j Application v 5.22b
|
| Table of Contents | < < Previous | Next >> |
Chapter Eleven — SGML Functions (continued)
Overview
The SGMLNextElement function moves the parser forward until an SGML tag (element) is found. An optional start position can be provided. By default, the parse continues from the current position.
Syntax/Parameters
Syntax
string = SGMLNextElement ( 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 SGMLNextElement skips all spaces, character entities and PCDATA to get to the next element. If the end of data is reached prior to a tag, an empty string is returned and ERROR_EOD will be placed in the last error buffer.
The current position, properties and other characteristic are made available through various ‘get’ functions.
Since SGMLNextElement only reads tags, the element attributes/properties are loaded into the SGML Object.
Related Functions
Platform Support
Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL
Legato IDE, Legato Basic
| Table of Contents | < < Previous | Next >> |
© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.