SAX-PARSE( ) method

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.