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, it can invoke callbacks, for different elements and events that occur during the execution of the parser. Callbacks are optional, and you do not need to define all the callbacks. The AVM invokes the corresponding callback, if defined, at the appropriate time. Callbacks can reside in one of the following::
  • As callback procedures in a procedure file whose handle has been assigned to the HANDLER attribute.
  • As callback methods in an object-oriented ABL class whose reference has been assigned to the EVENT-HANDLER-OBJECT 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.