GoFiler Legato Script Reference   Legato v 1.6d Application v 6.1b

Table of Contents	< < Previous	Next >>

 

Chapter Five — General Functions (continued)

XMLParseGetAttributes Function

Overview

The XMLParseGetAttributes function returns any attributes associated with the last parsed item as a list or table.

Syntax/Parameters

Syntax

string[]   = XMLParseGetAttributes ( handle hXPO, [boolean table_mode] );

string[][] = XMLParseGetAttributes ( handle hXPO, [boolean table_mode] );

Parameters

hXPO

A handle specifying an XML Parse Object.

table_mode

An optional boolean value which specifies whether to return the data in table form. The default value is FALSE.

Return Value

Returns a string array or table containing any attributes associated with the last parsed item or an empty array on failure. Use the GetLastError function to retrieve error information. The GetLastErrorMessage can contain information on ERROR_CONTEXT.

Remarks

Assuming that the last parse was not performed in raw mode and the tag parsed had attributes, the attributes can be retrieved as a keyed list or a table. The table made is preferable if the attribute names may violate the key name restrictions within Legato.

In list mode, each item is named by the attribute name. However, this means the incoming attributes must conform to the variable key name restrictions within Legato.

In table mode, two columns are returned named “name” and “value” or position 0 and 1, respectively.

If the last parsed element did not have any attributes, the function will return an empty set with the error ERROR_EOD.

Related Functions

XMLParseCreate — Create an XML Parse Object.

XMLParseGetConcept — Returns the concept name from the last parsed item.

XMLParseGetElement — Returns the element qname from the last parsed item.

XMLParseGetItem — Parses the next item and processes tab information as required.

XMLParseGetPrefix — Returns the element prefix as part of the qname for the last parsed item.

XMLParseIsComment — Tests whether the last item parsed was a comment.

XMLParseIsDeclaration — Tests whether the last item parsed was a declaration.

XMLParseIsSelfContained — Returns a boolean value as to whether the tag is self-contained.

XMLParseIsTag — Returns a boolean as to whether item parser was a tag.

Platform Support

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

Page revised 2025-08-15

 

Table of Contents	< < Previous	Next >>

GoFiler Legato Script Reference — Generated on 08/18/2025

© 2012-2025 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission is prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. Novaworks, GoFiler™ and Legato™ are registered 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 the 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.