Question

The QXmlLexicalHandler class provides an interface to report the lexical content of XML data. More...

#include <qxml.h>

Inherited by QXmlDefaultHandler.

List of all member functions.

Public Members

• virtual bool startDTD ( constQString&name, constQString&publicId, constQString&systemId ) = 0
• virtual bool endDTD () = 0
• virtual bool startEntity ( constQString&name ) = 0
• virtual bool endEntity ( constQString&name ) = 0
• virtual bool startCDATA () = 0
• virtual bool endCDATA () = 0
• virtual bool comment ( constQString&ch ) = 0
• virtual QString errorString () = 0

---

Detailed Description

The QXmlLexicalHandler class provides an interface to report the lexical content of XML data.

The events in the lexical handler apply to the entire document, not just to the document element, and all lexical handler events appear between the content handler's startDocument and endDocument events.

You can set the lexical handler with QXmlReader::setLexicalHandler().

This interface's design is based on the the SAX2 extension LexicalHandler.

The interface provides startDTD(), endDTD(), startEntity(), endEntity(), startCDATA(), endCDATA() and comment() functions.

See also the Introduction to SAX2.

See also QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler and XML.

---

Member Function Documentation

bool QXmlLexicalHandler::comment ( constQString&ch ) [pure virtual]

The reader calls this function to report an XML comment anywhere in the document. It reports the text of the comment in ch.

If this function returns FALSE the reader stops parsing and reports an error. The reader uses the function errorString() to get the error message.

bool QXmlLexicalHandler::endCDATA () [pure virtual]

The reader calls this function to report the end of a CDATA section.

If this function returns FALSE the reader stops parsing and reports an error. The reader uses the function errorString() to get the error message.

See also startCDATA().

bool QXmlLexicalHandler::endDTD () [pure virtual]

The reader calls this function to report the end of a DTD declaration, if any.

If this function returns FALSE the reader stops parsing and reports an error. The reader uses the function errorString() to get the error message.

See also startDTD().

bool QXmlLexicalHandler::endEntity ( constQString&name ) [pure virtual]

The reader calls this function to report the end of an entity with the name name.

For every call of startEntity(), there is a corresponding call of endEntity(). The calls of startEntity() and endEntity() are properly nested.

If this function returns FALSE the reader stops parsing and reports an error. The reader uses the function errorString() to get the error message.

See also startEntity() and QXmlSimpleReader::setFeature().

QString QXmlLexicalHandler::errorString () [pure virtual]

The reader calls this function to get an error string if any of the handler functions returns FALSE.

bool QXmlLexicalHandler::startCDATA () [pure virtual]

The reader calls this function to report the start of a CDATA section. The content of the CDATA section is reported through the QXmlContentHandler::characters() function. This function is intended only to report the boundary.

If this function returns FALSE the reader stops parsing and reports an error. The reader uses the function errorString() to get the error message.

See also endCDATA().

bool QXmlLexicalHandler::startDTD ( constQString&name, constQString&publicId, constQString&systemId ) [pure virtual]

The reader calls this function to report the start of a DTD declaration, if any. It reports the name of the document type in name, the public identifier in publicId and the system identifier in systemId.

If the public identifier and the system identifier is missing, the reader sets the publicId and systemId to QString::null.

All declarations reported through QXmlDTDHandler or QXmlDeclHandler appear between the startDTD() and endDTD() calls.

If this function returns FALSE the reader stops parsing and reports an error. The reader uses the function errorString() to get the error message.

See also endDTD().

bool QXmlLexicalHandler::startEntity ( constQString&name ) [pure virtual]

The reader calls this function to report the start of an entity with the name name.

Note that if the entity is unknown, the reader reports it through QXmlContentHandler::skippedEntity() and not throught this function.

If this function returns FALSE the reader stops parsing and reports an error. The reader uses the function errorString() to get the error message.

See also endEntity() and QXmlSimpleReader::setFeature().