SAX Interface

Table 6-1 summarizes the methods of available through the SAX interface.

XmlSaxAttributeDecl

This event marks an element declaration in the DTD. The element's name and content will be in the data encoding. Note that an attribute may be declared before the element it belongs to!

xmlerr XmlSaxAttributeDecl(
   void *ctx, 
   oratext *elem, 
   oratext *attr, 
   oratext *body)

ctx

IN

elem

IN

attr

IN

body

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxCDATA

This event handles CDATA, as distinct from Text. If no XmlSaxCDATA callback is provided, the Text callback will be invoked. The data will be in the data encoding, and the returned length is in characters, not bytes. See also XmlSaxWhitespace, which receiving notification about ignorable (whitespace formatting) character data.

xmlerr XmlSaxCDATA(
   void *ctx, 
   oratext *ch, 
   size_t len)

ctx

IN

ch

IN

len

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxCharacters

This event marks character data, either Text or CDATA. If an XmlSaxCDATA callback is provided, then CDATA will be send to that instead; with no XmlSaxCDATA callback, both Text and CDATA go to the XmlSaxCharacters callback. The data will be in the data encoding, and the returned length is in characters, not bytes. See also XmlSaxWhitespace, which receiving notification about ignorable (whitespace formatting) character data.

xmlerr XmlSaxCharacters(
   void *ctx, 
   oratext *ch, 
   size_t len)

ctx

IN

ch

IN

len

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxComment

This event marks a comment in the XML document. The comment's data will be in the data encoding. Oracle extension, not in SAX standard.

xmlerr XmlSaxComment(
   void *ctx, 
   oratext *data)

ctx

IN

data

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxElementDecl

This event marks an element declaration in the DTD. The element's name and content will be in the data encoding.

xmlerr XmlSaxElementDecl(
   void *ctx, 
   oratext *name, 
   oratext *content)

ctx

IN

name

IN

content

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxEndDocument

The last SAX event, called once for each document, indicating the end of the document. Matching event is XmlSaxStartDocument.

xmlerr XmlSaxEndDocument(
   void *ctx)

ctx

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxEndElement

This event marks the close of an element; it matches the XmlSaxStartElement or XmlSaxStartElementNS events. The name is the tagName of the element (which may be a qualified name for namespace-aware elements) and is in the data encoding.

xmlerr XmlSaxEndElement(
   void *ctx, 
   oratext *name)

ctx

IN

name

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxNotationDecl

The even marks the declaration of a notation in the DTD. The notation's name, public ID, and system ID will all be in the data encoding. Both IDs are optional and may be NULL.

xmlerr XmlSaxNotationDecl(
   void *ctx, 
   oratext *name, 
   oratext *pubId, 
   oratext *sysId)

ctx

IN

name

IN

pubId

IN

sysId

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxPI

This event marks a ProcessingInstruction. The ProcessingInstructions target and data will be in the data encoding. There is always a target, but the data may be NULL.

xmlerr XmlSaxPI(
   void *ctx, 
   oratext *target, 
   oratext *data)

ctx

IN

target

IN

data

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxParsedEntityDecl

Marks an parsed entity declaration in the DTD. The parsed entity's name, public ID, system ID, and notation name will all be in the data encoding.

xmlerr XmlSaxParsedEntityDecl(
   void *ctx, 
   oratext *name, 
   oratext *value, 
   oratext *pubId, 
   oratext *sysId, 
   boolean general)

ctx

IN

name

IN

value

IN

pubId

IN

sysId

IN

general

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxStartDocument

The first SAX event, called once for each document, indicating the start of the document. Matching event is XmlSaxEndDocument.

xmlerr XmlSaxStartDocument(
   void *ctx)

ctx

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxStartElement

This event marks the start of an element. Note this is the original SAX 1 non-namespace-aware version; XmlSaxStartElementNS is the SAX 2 namespace-aware version. If both are registered, only the NS version will be called. The element's name will be in the data encoding, as are all the attribute parts. See the functions in the NamedNodeMap interface for operating on the attributes map. The matching function is XmlSaxEndElement (there is no namespace aware version of this function).

xmlerr XmlSaxStartElement(
   void *ctx, 
   oratext *name, 
   xmlnodelist *attrs)

ctx

IN

name

IN

attrs

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxStartElementNS

This event marks the start of an element. Note this is the new SAX 2 namespace-aware version; XmlSaxStartElement is the SAX 1 non-namespace-aware version. If both are registered, only the NS version will be called. The element's qualified name, local name, and namespace URI will be in the data encoding, as are all the attribute parts. See the functions in the NamedNodeMap interface for operating on the attributes map. The matching function is XmlSaxEndElement (there is no namespace aware version of this function).

xmlerr XmlSaxStartElementNS(
   void *ctx, 
   oratext *qname, 
   oratext *local, 
   oratext *nsp, 
   xmlnodelist *attrs)

ctx

IN

qname

IN

local

IN

nsp

IN

attrs

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxUnparsedEntityDecl

Marks an unparsed entity declaration in the DTD, see XmlSaxParsedEntityDecl for the parsed entity version. The unparsed entity's name, public ID, system ID, and notation name will all be in the data encoding.

xmlerr XmlSaxUnparsedEntityDecl(
   void *ctx, 
   oratext *name, 
   oratext *pubId, 
   oratext *sysId, 
   oratext *note)

ctx

IN

name

IN

pubId

IN

sysId

IN

note

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxWhitespace

This event marks ignorable whitespace data such as newlines, and indentation between lines. The matching function is XmlSaxCharacters, which receives notification of normal character data. The data is in the data encoding, and the returned length is in characters, not bytes.

xmlerr XmlSaxWhitespace(
   void *ctx, 
   oratext *ch, 
   size_t len)

ctx

IN

ch

IN

len

IN

(xmlerr) error code, XMLERR_OK [0] for success

XmlSaxXmlDecl

This event marks an XML declaration. The XmlSaxStartDocument event is always first; if this callback is registered and an XMLDecl exists, it will be the second event. The encoding flag says whether an encoding was specified. Since the document's own encoding specification may be overridden (or wrong), and the input will be converted to the data encoding anyway, the actual encoding specified in the document is not provided. For the standalone flag, -1 will be returned if it was not specified, otherwise 0 for FALSE, 1 for TRUE.

xmlerr XmlSaxXmlDecl(
   void *ctx, 
   oratext *version, 
   boolean encoding, 
   sword standalone)

ctx

IN

version

IN

encoding

IN

standalone

IN

(xmlerr) error code, XMLERR_OK [0] for success