NAME<\/a> XML::LibXML::Reader \u2212 XML::LibXML::Reader \u2212 interface to libxml2 pull parser<\/p>\n use XML::LibXML::Reader; or<\/p>\n my $reader = XML::LibXML::Reader\u2212>new(location => “file.xml”) This is a perl interface to libxml2\u2019s pull-parser implementation xmlTextReader http:\/\/xmlsoft.org\/html\/libxml\u2212xmlreader.html<\/i>. This feature requires at least libxml2\u22122.6.21. Pull-parsers (such as StAX in Java, or XmlReader in C#) use an iterator approach to parse XML<\/small> documents. They are easier to program than event-based parser ( SAX<\/small> ) and much more lightweight than tree-based parser ( DOM<\/small> ), which load the complete tree into memory.<\/p>\n The Reader acts as a cursor going forward on the document stream and stopping at each node on the way. At every point, the DOM-like methods of the Reader object allow one to examine the current node (name, namespace, attributes, etc.)<\/p>\n The user\u2019s code keeps control of the progress and simply calls the “read()” function repeatedly to progress to the next node in the document order. Other functions provide means for skipping complete sub-trees, or nodes until a specific element, etc.<\/p>\n At every time, only a very limited portion of the document is kept in the memory, which makes the API<\/small> more memory-efficient than using DOM.<\/small> However, it is also possible to mix Reader with DOM.<\/small> At every point the user may copy the current node (optionally expanded into a complete sub-tree) from the processed document to another DOM<\/small> tree, or to instruct the Reader to collect sub-document in form of a DOM<\/small> tree consisting of selected nodes.<\/p>\n Reader API<\/small> also supports namespaces, xml:base, entity handling, and DTD<\/small> validation. Schema and RelaxNG validation support will probably be added in some later revision of the Perl interface.<\/p>\n The naming of methods compared to libxml2 and C# XmlTextReader has been changed slightly to match the conventions of XML::LibXML. Some functions have been changed or added with respect to the C interface.<\/p>\n Depending on the XML<\/small> source, the Reader object can be created with either of:<\/p>\n my $reader = XML::LibXML::Reader\u2212>new( location => “file.xml”, … ); where … are (optional) reader options described below in “Reader options” or various parser options described in XML::LibXML::Parser. The constructor recognizes the following XML<\/small> sources:<\/p>\n Source specification<\/b> Read XML<\/small> from a local file or (non-HTTPS) URL.<\/small><\/p>\n string<\/p>\n Read XML<\/small> from a string.<\/p>\n
SYNOPSIS<\/a>
DESCRIPTION<\/a>
CONSTRUCTOR<\/a>
METHODS CONTROLLING PARSING PROGRESS<\/a>
METHODS EXTRACTING INFORMATION<\/a>
METHODS EXTRACTING DOM NODES<\/a>
METHODS PROCESSING ATTRIBUTES<\/a>
OTHER METHODS<\/a>
DESTRUCTION<\/a>
NODE TYPES<\/a>
STATES<\/a>
SEE ALSO<\/a>
ORIGINAL IMPLEMENTATION<\/a>
AUTHORS<\/a>
VERSION<\/a>
COPYRIGHT<\/a>
LICENSE<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
SYNOPSIS <\/a> <\/h2>\n
my $reader = XML::LibXML::Reader\u2212>new(location => “file.xml”)
or die “cannot read file.xmln”;
while ($reader\u2212>read) {
processNode($reader);
}
sub processNode {
my $reader = shift;
printf “%d %d %s %dn”, ($reader\u2212>depth,
$reader\u2212>nodeType,
$reader\u2212>name,
$reader\u2212>isEmptyElement);
}<\/p>\n
or die “cannot read file.xmln”;
$reader\u2212>preservePattern(‘\/\/table\/tr’);
$reader\u2212>finish;
print $reader\u2212>document\u2212>toString(1);<\/p>\nDESCRIPTION <\/a> <\/h2>\n
CONSTRUCTOR <\/a> <\/h2>\n
my $reader = XML::LibXML::Reader\u2212>new( string => $xml_string, … );
my $reader = XML::LibXML::Reader\u2212>new( IO => $file_handle, … );
my $reader = XML::LibXML::Reader\u2212>new( FD => fileno(STDIN), … );
my $reader = XML::LibXML::Reader\u2212>new( DOM => $dom, … );<\/p>\n
location<\/p>\n