Performs a single-call parse of an XML document associated with a SAX-reader object.

Return type: None

Applies to: SAX-reader object handle

Syntax

SAX-PARSE ( )

Returns when one of the following occurs:

  • The parser reaches the end of the document.
  • A callback invokes RETURN ERROR.
  • An error occurred because the parser could not start or could not continue parsing.

While SAX-PARSE( ) is running, each time the parser detects an XML element, the AVM invokes the corresponding callback. Callbacks reside in a procedure file whose handle has been assigned to the HANDLER attribute.

Note: SAX-PARSE( ) does not have a return value. To detect if an error has occurred, add NO-ERROR to the call and when it returns, check ERROR-STATUS:ERROR.