Progress
Version 9
Product Update Bulletin


SAX-PARSE-FIRST() Method

Initializes a progressive-scan parse of an XML document associated with a SAX-READER object.

Called to begin the parse.

Return Type: No return value.

Applies To: SAX-READER Object

SYNTAX

SAX-PARSE-FIRST ( ) 

To continue a progressive-scan parse, call SAX-PARSE-NEXT() repeatedly.

When SAX-PARSE-FIRST() executes, Progress invokes the StartDocument callback, if there is one.

SAX-PARSE-FIRST() raises a Progress error if the parser fails, for any reason, to start parsing the XML source.

If SAX-PARSE-FIRST() is called on a source file already being parsed with SAX-PARSE-NEXT(), the parser reinitializes the parsing process.

SAX-PARSE-FIRST() can be called with SAX-READER in any state.

NOTE: SAX-PARSE-FIRST() does not have a return value. To detect if an error has occurred, add NO-ERROR to the call and when it returns, check ERROR-STATUS:ERROR.


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