TreeHandler Class Reference

A SAX interface implementation for constructing an in-memory DOM model. More...

#include <xml.hh>

Inheritance diagram for TreeHandler:

Collaboration diagram for TreeHandler:

Public Member Functions
virtual void	setDocumentLocator (Locator locator)
	Set the Locator object for documents.
virtual void	startDocument (void)
	Start processing a new XML document.
virtual void	endDocument (void)
	End processing for the current XML document.
virtual void	startPrefixMapping (const string &prefix, const string &uri)
	Start a new prefix to namespace URI mapping.
virtual void	endPrefixMapping (const string &prefix)
	Finish the current prefix.
virtual void	startElement (const string &namespaceURI, const string &localName, const string &qualifiedName, const Attributes &atts)
	Callback indicating a new XML element has started. More...
virtual void	endElement (const string &namespaceURI, const string &localName, const string &qualifiedName)
	Callback indicating parsing of the current XML element is finished. More...
virtual void	characters (const char *text, int4 start, int4 length)
	Callback with raw characters to be inserted in the current XML element. More...
virtual void	ignorableWhitespace (const char *text, int4 start, int4 length)
	Callback with whitespace character data for the current XML element. More...
virtual void	processingInstruction (const string &target, const string &data)
	Callback for a formal processing instruction seen in the current document. More...
virtual void	setVersion (const string &val)
	Set the XML version as specified by the current document. More...
virtual void	setEncoding (const string &val)
	Set the character encoding as specified by the current document. More...
virtual void	skippedEntity (const string &name)
	Callback for an XML entity skipped by the parser. More...
virtual void	setError (const string &errmsg)
	Callback for handling an error condition during XML parsing. More...

Detailed Description

A SAX interface implementation for constructing an in-memory DOM model.

This implementation builds a DOM model of the XML stream being parsed, creating an Element object for each XML element tag in the stream. This handler is initialized with a root Element object, which after parsing is complete will own all parsed elements.

Member Function Documentation

characters()

void TreeHandler::characters ( const char *  text, int4  start, int4  length  )

virtual

Callback with raw characters to be inserted in the current XML element.

Parameters

text	is an array of character data being inserted.
start	is the first character within the array to insert.
length	is the number of characters to insert.

Implements ContentHandler.

endElement()

void TreeHandler::endElement ( const string &  namespaceURI, const string &  localName, const string &  qualifiedName  )

virtual

Callback indicating parsing of the current XML element is finished.

Parameters

namespaceURI	is the namespace to which the element belongs
localName	is the local name of the new element
qualifiedName	is the fully qualified name of the element.

Implements ContentHandler.

ignorableWhitespace()

virtual void TreeHandler::ignorableWhitespace ( const char *  text, int4  start, int4  length  )

inlinevirtual

Callback with whitespace character data for the current XML element.

Parameters

text	is an array of character data that can be inserted.
start	is the first character within the array to insert.
length	is the number of characters to insert.

Implements ContentHandler.

processingInstruction()

virtual void TreeHandler::processingInstruction ( const string &  target, const string &  data  )

inlinevirtual

Callback for a formal processing instruction seen in the current document.

Parameters

target	is the target instruction to process
data	is (optional) character data for the instruction

Implements ContentHandler.

setEncoding()

virtual void TreeHandler::setEncoding ( const string &  encoding )

inlinevirtual

Set the character encoding as specified by the current document.

Parameters

encoding

is the parsed encoding string

Implements ContentHandler.

setError()

virtual void TreeHandler::setError ( const string &  errmsg )

inlinevirtual

Callback for handling an error condition during XML parsing.

Parameters

errmsg

is a message describing the error condition

Implements ContentHandler.

setVersion()

virtual void TreeHandler::setVersion ( const string &  version )

inlinevirtual

Set the XML version as specified by the current document.

Parameters

version

is the parsed version string

Implements ContentHandler.

skippedEntity()

virtual void TreeHandler::skippedEntity ( const string &  name )

inlinevirtual

Callback for an XML entity skipped by the parser.

Parameters

name	is the name of the entity being skipped

Implements ContentHandler.

startElement()

void TreeHandler::startElement ( const string &  namespaceURI, const string &  localName, const string &  qualifiedName, const Attributes &  atts  )

virtual

Callback indicating a new XML element has started.

Parameters

namespaceURI	is the namespace to which the new element belongs
localName	is the local name of the new element
qualifiedName	is the fully qualified name of the new element
atts	is the set of (previously parsed) attributes to attach to the new element

Implements ContentHandler.

---

The documentation for this class was generated from the following files:

• xml.hh
• xml.cc