Progress
Version 9
Product Update Bulletin


STOP-PARSING() Method

Causes the parser to stop parsing the XML source. 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

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 SAX-READER’s 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, Progress continues to execute the callback as usual, but when the callback finishes, control returns to the next 4GL statement after the most-recently-executed SAX-PARSE(), SAX-PARSE-FIRST(), or SAX-PARSE-NEXT().


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095