#include <DbXml.hpp>

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

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.

• Local name of the element.

• Namespace prefix, or NULL.

• Namespace uri, or NULL.

• Number of attributes.

• 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.

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

• 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.