enum xmlParserProperties

typedef enum {
    XML_PARSER_LOADDTD = 1,
    XML_PARSER_DEFAULTATTRS = 2,
    XML_PARSER_VALIDATE = 3,
    XML_PARSER_SUBST_ENTITIES = 4
} xmlParserProperties;

enum xmlParserSeverities

typedef enum {
    XML_PARSER_SEVERITY_VALIDITY_WARNING = 1,
    XML_PARSER_SEVERITY_VALIDITY_ERROR = 2,
    XML_PARSER_SEVERITY_WARNING = 3,
    XML_PARSER_SEVERITY_ERROR = 4
} xmlParserSeverities;

enum xmlReaderTypes

typedef enum {
    XML_READER_TYPE_NONE = 0,
    XML_READER_TYPE_ELEMENT = 1,
    XML_READER_TYPE_ATTRIBUTE = 2,
    XML_READER_TYPE_TEXT = 3,
    XML_READER_TYPE_CDATA = 4,
    XML_READER_TYPE_ENTITY_REFERENCE = 5,
    XML_READER_TYPE_ENTITY = 6,
    XML_READER_TYPE_PROCESSING_INSTRUCTION = 7,
    XML_READER_TYPE_COMMENT = 8,
    XML_READER_TYPE_DOCUMENT = 9,
    XML_READER_TYPE_DOCUMENT_TYPE = 10,
    XML_READER_TYPE_DOCUMENT_FRAGMENT = 11,
    XML_READER_TYPE_NOTATION = 12,
    XML_READER_TYPE_WHITESPACE = 13,
    XML_READER_TYPE_SIGNIFICANT_WHITESPACE = 14,
    XML_READER_TYPE_END_ELEMENT = 15,
    XML_READER_TYPE_END_ENTITY = 16,
    XML_READER_TYPE_XML_DECLARATION = 17
} xmlReaderTypes;

struct xmlTextReader

struct xmlTextReader;

xmlTextReaderPtr

typedef xmlTextReader *xmlTextReaderPtr;

xmlNewTextReader ()

xmlTextReaderPtr xmlNewTextReader           (xmlParserInputBufferPtr input,
                                             const char *URI);

Create an xmlTextReader structure fed with input

xmlNewTextReaderFilename ()

xmlTextReaderPtr xmlNewTextReaderFilename   (const char *URI);

Create an xmlTextReader structure fed with the resource at URI

xmlFreeTextReader ()

void        xmlFreeTextReader               (xmlTextReaderPtr reader);

Deallocate all the resources associated to the reader

xmlTextReaderRead ()

int         xmlTextReaderRead               (xmlTextReaderPtr reader);

Moves the position of the current instance to the next node in the stream, exposing its properties.

xmlTextReaderReadInnerXml ()

xmlChar*    xmlTextReaderReadInnerXml       (xmlTextReaderPtr reader);

Reads the contents of the current node, including child nodes and markup.

xmlTextReaderReadOuterXml ()

xmlChar*    xmlTextReaderReadOuterXml       (xmlTextReaderPtr reader);

Reads the contents of the current node, including child nodes and markup.

xmlTextReaderReadString ()

xmlChar*    xmlTextReaderReadString         (xmlTextReaderPtr reader);

Reads the contents of an element or a text node as a string.

xmlTextReaderReadAttributeValue ()

int         xmlTextReaderReadAttributeValue (xmlTextReaderPtr reader);

Parses an attribute value into one or more Text and EntityReference nodes.

xmlTextReaderAttributeCount ()

int         xmlTextReaderAttributeCount     (xmlTextReaderPtr reader);

Provides the number of attributes of the current node

xmlTextReaderBaseUri ()

xmlChar*    xmlTextReaderBaseUri            (xmlTextReaderPtr reader);

The base URI of the node.

xmlTextReaderDepth ()

int         xmlTextReaderDepth              (xmlTextReaderPtr reader);

The depth of the node in the tree.

xmlTextReaderHasAttributes ()

int         xmlTextReaderHasAttributes      (xmlTextReaderPtr reader);

Whether the node has attributes.

xmlTextReaderHasValue ()

int         xmlTextReaderHasValue           (xmlTextReaderPtr reader);

Whether the node can have a text value.

xmlTextReaderIsDefault ()

int         xmlTextReaderIsDefault          (xmlTextReaderPtr reader);

Whether an Attribute node was generated from the default value defined in the DTD or schema.

xmlTextReaderIsEmptyElement ()

int         xmlTextReaderIsEmptyElement     (xmlTextReaderPtr reader);

Check if the current node is empty

xmlTextReaderLocalName ()

xmlChar*    xmlTextReaderLocalName          (xmlTextReaderPtr reader);

The local name of the node.

xmlTextReaderName ()

xmlChar*    xmlTextReaderName               (xmlTextReaderPtr reader);

The qualified name of the node, equal to Prefix :LocalName.

xmlTextReaderNamespaceUri ()

xmlChar*    xmlTextReaderNamespaceUri       (xmlTextReaderPtr reader);

The URI defining the namespace associated with the node.

xmlTextReaderNodeType ()

int         xmlTextReaderNodeType           (xmlTextReaderPtr reader);

Get the node type of the current node Reference: http://dotgnu.org/pnetlib-doc/System/Xml/XmlNodeType.html

xmlTextReaderPrefix ()

xmlChar*    xmlTextReaderPrefix             (xmlTextReaderPtr reader);

A shorthand reference to the namespace associated with the node.

xmlTextReaderQuoteChar ()

int         xmlTextReaderQuoteChar          (xmlTextReaderPtr reader);

The quotation mark character used to enclose the value of an attribute.

xmlTextReaderValue ()

xmlChar*    xmlTextReaderValue              (xmlTextReaderPtr reader);

Provides the text value of the node if present

xmlTextReaderXmlLang ()

xmlChar*    xmlTextReaderXmlLang            (xmlTextReaderPtr reader);

The xml:lang scope within which the node resides.

xmlTextReaderReadState ()

int         xmlTextReaderReadState          (xmlTextReaderPtr reader);

Gets the read state of the reader.

xmlTextReaderClose ()

int         xmlTextReaderClose              (xmlTextReaderPtr reader);

This method releases any resources allocated by the current instance changes the state to Closed and close any underlying input.

xmlTextReaderGetAttributeNo ()

xmlChar*    xmlTextReaderGetAttributeNo     (xmlTextReaderPtr reader,
                                             int no);

Provides the value of the attribute with the specified index relative to the containing element.

xmlTextReaderGetAttribute ()

xmlChar*    xmlTextReaderGetAttribute       (xmlTextReaderPtr reader,
                                             const xmlChar *name);

Provides the value of the attribute with the specified qualified name.

xmlTextReaderGetAttributeNs ()

xmlChar*    xmlTextReaderGetAttributeNs     (xmlTextReaderPtr reader,
                                             const xmlChar *localName,
                                             const xmlChar *namespaceURI);

Provides the value of the specified attribute

xmlTextReaderGetRemainder ()

xmlParserInputBufferPtr xmlTextReaderGetRemainder
                                            (xmlTextReaderPtr reader);

Method to get the remainder of the buffered XML. this method stops the parser, set its state to End Of File and return the input stream with what is left that the parser did not use.

xmlTextReaderLookupNamespace ()

xmlChar*    xmlTextReaderLookupNamespace    (xmlTextReaderPtr reader,
                                             const xmlChar *prefix);

Resolves a namespace prefix in the scope of the current element.

xmlTextReaderMoveToAttributeNo ()

int         xmlTextReaderMoveToAttributeNo  (xmlTextReaderPtr reader,
                                             int no);

Moves the position of the current instance to the attribute with the specified index relative to the containing element.

xmlTextReaderMoveToAttribute ()

int         xmlTextReaderMoveToAttribute    (xmlTextReaderPtr reader,
                                             const xmlChar *name);

Moves the position of the current instance to the attribute with the specified qualified name.

xmlTextReaderMoveToAttributeNs ()

int         xmlTextReaderMoveToAttributeNs  (xmlTextReaderPtr reader,
                                             const xmlChar *localName,
                                             const xmlChar *namespaceURI);

Moves the position of the current instance to the attribute with the specified local name and namespace URI.

xmlTextReaderMoveToFirstAttribute ()

int         xmlTextReaderMoveToFirstAttribute
                                            (xmlTextReaderPtr reader);

Moves the position of the current instance to the first attribute associated with the current node.

xmlTextReaderMoveToNextAttribute ()

int         xmlTextReaderMoveToNextAttribute
                                            (xmlTextReaderPtr reader);

Moves the position of the current instance to the next attribute associated with the current node.

xmlTextReaderMoveToElement ()

int         xmlTextReaderMoveToElement      (xmlTextReaderPtr reader);

Moves the position of the current instance to the node that contains the current Attribute node.

xmlTextReaderNormalization ()

int         xmlTextReaderNormalization      (xmlTextReaderPtr reader);

The value indicating whether to normalize white space and attribute values. Since attribute value and end of line normalizations are a MUST in the XML specification only the value true is accepted. The broken bahaviour of accepting out of range character entities like &0; is of course not supported either.

xmlTextReaderSetParserProp ()

int         xmlTextReaderSetParserProp      (xmlTextReaderPtr reader,
                                             int prop,
                                             int value);

Change the parser processing behaviour by changing some of its internal properties. Note that some properties can only be changed before any read has been done.

xmlTextReaderGetParserProp ()

int         xmlTextReaderGetParserProp      (xmlTextReaderPtr reader,
                                             int prop);

Read the parser internal property.

xmlTextReaderCurrentNode ()

xmlNodePtr  xmlTextReaderCurrentNode        (xmlTextReaderPtr reader);

Hacking interface allowing to get the xmlNodePtr correponding to the current node being accessed by the xmlTextReader. This is dangerous because the underlying node may be destroyed on the next Reads.

xmlTextReaderCurrentDoc ()

xmlDocPtr   xmlTextReaderCurrentDoc         (xmlTextReaderPtr reader);

Hacking interface allowing to get the xmlDocPtr correponding to the current document being accessed by the xmlTextReader. This is dangerous because the associated node may be destroyed on the next Reads.

xmlTextReaderExpand ()

xmlNodePtr  xmlTextReaderExpand             (xmlTextReaderPtr reader);

Reads the contents of the current node and the full subtree. It then makes the subtree available until the next xmlTextReaderRead() call

xmlTextReaderNext ()

int         xmlTextReaderNext               (xmlTextReaderPtr reader);

Skip to the node following the current one in document order while avoiding the subtree if any.

xmlTextReaderIsValid ()

int         xmlTextReaderIsValid            (xmlTextReaderPtr reader);

Retrieve the validity status from the parser context

xmlTextReaderRelaxNGValidate ()

int         xmlTextReaderRelaxNGValidate    (xmlTextReaderPtr reader,
                                             const char *rng);

Use RelaxNG to validate the document as it is processed. Activation is only possible before the first Read(). if rng is NULL, then RelaxNG validation is desactivated.

xmlTextReaderRelaxNGSetSchema ()

int         xmlTextReaderRelaxNGSetSchema   (xmlTextReaderPtr reader,
                                             xmlRelaxNGPtr schema);

Use RelaxNG to validate the document as it is processed. Activation is only possible before the first Read(). if schema is NULL, then RelaxNG validation is desactivated. @ The schema should not be freed until the reader is deallocated or its use has been deactivated.

xmlTextReaderLocatorPtr

typedef void *  xmlTextReaderLocatorPtr;

xmlTextReaderErrorFunc ()

void        (*xmlTextReaderErrorFunc)       (void *arg,
                                             const char *msg,
                                             xmlParserSeverities severity,
                                             xmlTextReaderLocatorPtr locator);

xmlTextReaderLocatorLineNumber ()

int         xmlTextReaderLocatorLineNumber  (xmlTextReaderLocatorPtr locator);

Obtain the line number for the given locator.

xmlTextReaderLocatorBaseURI ()

xmlChar*    xmlTextReaderLocatorBaseURI     (xmlTextReaderLocatorPtr locator);

Obtain the base URI for the given locator.

xmlTextReaderSetErrorHandler ()

void        xmlTextReaderSetErrorHandler    (xmlTextReaderPtr reader,
                                             xmlTextReaderErrorFunc f,
                                             void *arg);

Register a callback function that will be called on error and warnings.

If f is NULL, the default error and warning handlers are restored.

xmlTextReaderGetErrorHandler ()

void        xmlTextReaderGetErrorHandler    (xmlTextReaderPtr reader,
                                             xmlTextReaderErrorFunc *f,
                                             void **arg);

Retrieve the error callback function and user argument.