#include <DbXml.hpp>

virtual void XmlEventWriter::writeStartElement(const unsigned char *localName,
	     				     const unsigned char *prefix,
	     				     const unsigned char *uri,
					     int numAttributes,
					     bool isEmpty)

Description: XmlEventWriter::writeStartElement

Write an element event to the XmlEventWriter. If the element is empty, and specified as such using the isEmpty parameter, it must not be followed by an XmlEventWriter::writeEndElement call.

Parameters

localName

Local name of the element.

prefix

Namespace prefix, or NULL.

uri

Namespace uri, or NULL.

numAttributes

Number of attributes.

isEmpty

True if the element is empty. If this parameter is false, an EndElement event must be written later using XmlEventWriter::writeEndElement if true, XmlEventWriter::writeEndElement must not be called for this element.

Errors

The XmlEventWriter::writeStartElement method may fail and throw XmlException, encapsulating one of the following non-zero errors:

EVENT_ERROR

An error occurred during processing of an XmlEventWriter object. Most likely the error is attempting to write a type or value that is not valid in the current state of the object.