Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6ISAX2ContentHandler::endElement ( P6SAX2STRING pURI,
P6SAX2STRING pLocalName,
P6SAX2STRING pQName 
)
pure virtual

Provides an application the notification when the most recent element (as defined by a callback of the startElement method below) has ended.

An element is defined by a start tag, potentially some element content, and an end tag.

One example of an element can be: <money> 53 dollars and 35 cents</money>, this method will be called when the parser reaches the "&lt;/money&gt;" series of characters. Another example of an element can be: <money currency="us" />, which is an empty element, that is has no element content. This case looks the same as the previous example except that the characters() method (above) is never called. That is for an empty element both the startElement() and endElement() methods are called.

All P6SAX2STRING values are ONLY valid during this callback. An application that wants to keep a copy of the string MUST make a copy during this method call.

Parameters
pURI[ out ] indicates the namespace defined in the element, can be empty (i.e., pURI->length is zer0 and pURI->pStart is NULL) if no namespace was defined in the element.
pLocalName[ out ] simply the element's name (e.g., "money" for the '<money>' example above)
pQName[ out ] If a namespace was used for the element then the entire qualified name (e.g., <USA:money> ... </USA:money>, the QName would be "USA:money".
Returns
SuccessP6R::eOk 
FailureP6R::eInvalidArgOne of the parameters is NULL.