%XML_PARSER_ERROR

Get the last XML parser error

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
status = %XML_PARSER_ERROR(parser, error)

Return value

status

XML_SUCCESS if a nonblank error message is returned.

Arguments

parser

The parser instance. (XML_PARSER_TYPE)

error

Returned with the text of the last parser error. (a)

Discussion

%XML_PARSER_ERROR obtains the last error encountered by the DOM parser when parsing an XML file or string. Possible errors are as follows:

Possible XML Errors

Error message

Cause

One of several Synergy file I/O error messages

The %XML_PARSER_PARSEFILE routine had trouble opening the XML file. See the Synergy Errors tab for details about the specific error you received.

Invalid XML. Missing closing tag <elementName>

The XML is missing the closing tag for the specified element name.

Invalid XML. Missing closing >

A tag is missing a closing “>” character.

Invalid XML. Unexpectedly encountered <

The parser encountered an opening tag character (<) while looking for a closing tag character (>).

Invalid XML. Expecting closing quote for attribute <attrib_name>

The specified attribute value is missing a closing quotation mark.

Invalid XML. Error reading text

The text value for an element is not located between an opening and a closing tag.

Invalid XML. Error reading comment

The parser cannot find the closing comment characters “‑‑>”.

Invalid XML. Error reading declaration

The parser cannot find a closing “>” character for a declaration.

Invalid XML. Error reading XML declaration

The parser cannot find closing “?>” characters for the XML declaration.

This function is defined as ^VAL.

Examples

See Example of parsing XML.