![]() |
| ||
Classes - Annotated - Tree - Functions - Home - Structure |
The QXmlSimpleReader class provides an implementation of a simple XML reader (i.e. parser). More...
#include <qxml.h>
Inherits QXmlReader.
This XML reader is sufficient for simple parsing tasks. Here is a short list of the properties of this reader:
To get started see also the tiny SAX2 parser walkthrough.
More information about features can be found in the Qt SAX2 overview.
See also setFeature().
If incremental is TRUE, the parser does not return FALSE when it reaches the end of the input without reaching the end of the XML file. It rather stores the state of the parser so that parsing can be continued at a later state when more data is available. You can use the function parseContinue() to continue with parsing. This class stores a pointer to the input source input and the parseContinue() tries to read from that input souce. This means you should not delete the input source input until you don't call any further parseContinue().
If incremental is TRUE and the class was used before to do incremental parsing, the state of that parsing session is lost: this function will always start a new parsing session.
If incremental is FALSE, this function behaves like the normal parse function, i.e. it returns FALSE when the end of input is reached without reaching the end of the XML file and the parsing can't be continued.
See also parseContinue() and QSocket.
If the input source returns an empty string for the function QXmlInputSource::data(), then this means that the end of the XML file is reached; this is quite important, especially if you want to use the reader to parse more than one XML file.
This function returns FALSE in the case of a parsing error, otherwise it returns TRUE.
The case that the end of the XML file is reached without having finished the parsing is not considered as an error -- you can continue parsing at a later state by calling this function again when there is more data available to parse.
This function assumes that the end of the XML document is reached if the QXmlInputSource::next() function returns QXmlInputSource::EndOfDocument. If the parser has not finished the parsing when it encounters this symbol, then it considers this situation as an error and this function returns FALSE.
See also parse() and QXmlInputSource::next().
Search the documentation, FAQ, qt-interest archive and more (uses
www.trolltech.com):
This file is part of the Qt toolkit, copyright © 1995-2001 Trolltech, all rights reserved.
Copyright © 2001 Trolltech | Trademarks | Qt version 3.0.0-beta2
|