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