|
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 "</money>" 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.
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". |
Success | P6R::eOk | |
Failure | P6R::eInvalidArg | One of the parameters is NULL. |