Causes the parser to stop parsing the XML document. This lets an application search for particular data, then abort the parse as soon as the data are found.

Return type: LOGICAL

Applies to: SAX-reader object handle

Syntax

STOP-PARSING ( )

STOP-PARSING( ) can stop a parse started by SAX-PARSE( ), SAX-PARSE-FIRST( ) or SAX-PARSE-NEXT( ). That is, the parse can be single call or multiple scan.

STOP-PARSING sets the PARSE-STATUS attribute to SAX-COMPLETE.

Within a callback, to invoke STOP-PARSING( ), use the SELF system handle, as shown in the following fragment:

SELF:STOP-PARSING( ).

If STOP-PARSING( ) is invoked in a callback or in any procedure called directly or indirectly by a callback, the AVM continues to execute the callback as usual, but when the callback finishes, control returns to the next ABL statement after the most-recently-executed SAX-PARSE( ), SAX-PARSE-FIRST( ), or SAX-PARSE-NEXT( ).