The XMLReader class

Introduction

The XMLReader extension is an XML Pull parser. The reader acts as a cursor going forward on the document stream and stopping at each node on the way.

Class synopsis

XMLReader

/* Constants */

public const int XMLReader::NONE;

public const int XMLReader::ELEMENT;

public const int XMLReader::ATTRIBUTE;

public const int XMLReader::TEXT;

public const int XMLReader::CDATA;

public const int XMLReader::ENTITY_REF;

public const int XMLReader::ENTITY;

public const int XMLReader::PI;

public const int XMLReader::COMMENT;

public const int XMLReader::DOC;

public const int XMLReader::DOC_TYPE;

public const int XMLReader::DOC_FRAGMENT;

public const int XMLReader::NOTATION;

public const int XMLReader::WHITESPACE;

public const int XMLReader::SIGNIFICANT_WHITESPACE;

public const int XMLReader::END_ELEMENT;

public const int XMLReader::END_ENTITY;

public const int XMLReader::XML_DECLARATION;

public const int XMLReader::LOADDTD;

public const int XMLReader::DEFAULTATTRS;

public const int XMLReader::VALIDATE;

public const int XMLReader::SUBST_ENTITIES;

/* Properties */

public int $attributeCount;

public string $baseURI;

public int $depth;

public bool $hasAttributes;

public bool $hasValue;

public bool $isDefault;

public bool $isEmptyElement;

public string $localName;

public string $name;

public string $namespaceURI;

public int $nodeType;

public string $prefix;

public string $value;

public string $xmlLang;

/* Methods */

public true close()

public DOMNodefalse expand(DOMNodenull $baseNode = null)

public stringnull getAttribute(string $name)

public stringnull getAttributeNo(int $index)

public stringnull getAttributeNs(string $name, string $namespace)

public bool getParserProperty(int $property)

public bool isValid()

public stringnull lookupNamespace(string $prefix)

public bool moveToAttribute(string $name)

public bool moveToAttributeNo(int $index)

public bool moveToAttributeNs(string $name, string $namespace)

public bool moveToElement()

public bool moveToFirstAttribute()

public bool moveToNextAttribute()

public bool next(stringnull $name = null)

public static XMLReader open(string $uri, stringnull $encoding = null, int $flags = 0)

public bool open(string $uri, stringnull $encoding = null, int $flags = 0)

public bool read()

public string readInnerXml()

public string readOuterXml()

public string readString()

public bool setParserProperty(int $property, bool $value)

public bool setRelaxNGSchema(stringnull $filename)

public bool setRelaxNGSchemaSource(stringnull $source)

public bool setSchema(stringnull $filename)

public static XMLReader XML(string $source, stringnull $encoding = null, int $flags = 0)

public bool XML(string $source, stringnull $encoding = null, int $flags = 0)

Properties

attributeCount: The number of attributes on the node
baseURI: The base URI of the node
depth: Depth of the node in the tree, starting at 0
hasAttributes: Indicates if node has attributes
hasValue: Indicates if node has a text value
isDefault: Indicates if attribute is defaulted from DTD
isEmptyElement: Indicates if node is an empty element tag
localName: The local name of the node
name: The qualified name of the node
namespaceURI: The URI of the namespace associated with the node
nodeType: The node type for the node
prefix: The prefix of the namespace associated with the node
value: The text value of the node
xmlLang: The xml:lang scope which the node resides

Predefined Constants

XMLReader Node Types

XMLReader::NONE: No node type
XMLReader::ELEMENT: Start element
XMLReader::ATTRIBUTE: Attribute node
XMLReader::TEXT: Text node
XMLReader::CDATA: CDATA node
XMLReader::ENTITY_REF: Entity Reference node
XMLReader::ENTITY: Entity Declaration node
XMLReader::PI: Processing Instruction node
XMLReader::COMMENT: Comment node
XMLReader::DOC: Document node
XMLReader::DOC_TYPE: Document Type node
XMLReader::DOC_FRAGMENT: Document Fragment node
XMLReader::NOTATION: Notation node
XMLReader::WHITESPACE: Whitespace node
XMLReader::SIGNIFICANT_WHITESPACE: Significant Whitespace node
XMLReader::END_ELEMENT: End Element
XMLReader::END_ENTITY: End Entity
XMLReader::XML_DECLARATION: XML Declaration node

XMLReader Parser Options

XMLReader::LOADDTD: Load DTD but do not validate
XMLReader::DEFAULTATTRS: Load DTD and default attributes but do not validate
XMLReader::VALIDATE: Load DTD and validate while parsing
XMLReader::SUBST_ENTITIES: Substitute entities and expand references

Table of Contents

XMLReader::close — Close the XMLReader input
XMLReader::expand — Returns a copy of the current node as a DOM object
XMLReader::getAttribute — Get the value of a named attribute
XMLReader::getAttributeNo — Get the value of an attribute by index
XMLReader::getAttributeNs — Get the value of an attribute by localname and URI
XMLReader::getParserProperty — Indicates if specified property has been set
XMLReader::isValid — Indicates if the parsed document is valid
XMLReader::lookupNamespace — Lookup namespace for a prefix
XMLReader::moveToAttribute — Move cursor to a named attribute
XMLReader::moveToAttributeNo — Move cursor to an attribute by index
XMLReader::moveToAttributeNs — Move cursor to a named attribute
XMLReader::moveToElement — Position cursor on the parent Element of current Attribute
XMLReader::moveToFirstAttribute — Position cursor on the first Attribute
XMLReader::moveToNextAttribute — Position cursor on the next Attribute
XMLReader::next — Move cursor to next node skipping all subtrees
XMLReader::open — Set the URI containing the XML to parse
XMLReader::read — Move to next node in document
XMLReader::readInnerXml — Retrieve XML from current node
XMLReader::readOuterXml — Retrieve XML from current node, including itself
XMLReader::readString — Reads the contents of the current node as a string
XMLReader::setParserProperty — Set parser options
XMLReader::setRelaxNGSchema — Set the filename or URI for a RelaxNG Schema
XMLReader::setRelaxNGSchemaSource — Set the data containing a RelaxNG Schema
XMLReader::setSchema — Validate document against XSD
XMLReader::XML — Set the data containing the XML to parse