Try OpenEdge Now
skip to main content
ABL Reference
Handle Attributes and Methods Reference : STOP-PARSING( ) method
 

STOP-PARSING( ) method

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