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
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:
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( ).