man pages section 3: Library Interfaces and Headers

XML::Parser::Style::Stream (3)

Name

XML::Parser::Style::Stream - Stream style for XML::Parser

Synopsis

use XML::Parser;
my $p = XML::Parser->new(Style => 'Stream', Pkg => 'MySubs');
$p->parsefile('foo.xml');

{
package MySubs;

sub StartTag {
my ($e, $name) = @_;
# do something with start tags
}

sub EndTag {
my ($e, $name) = @_;
# do something with end tags
}

sub Characters {
my ($e, $data) = @_;
# do something with text nodes
}
}

Description

User Contributed Perl Documentation                   Parser::Style::Stream(3)



NAME
       XML::Parser::Style::Stream - Stream style for XML::Parser

SYNOPSIS
         use XML::Parser;
         my $p = XML::Parser->new(Style => 'Stream', Pkg => 'MySubs');
         $p->parsefile('foo.xml');

         {
           package MySubs;

           sub StartTag {
             my ($e, $name) = @_;
             # do something with start tags
           }

           sub EndTag {
             my ($e, $name) = @_;
             # do something with end tags
           }

           sub Characters {
             my ($e, $data) = @_;
             # do something with text nodes
           }
         }

DESCRIPTION
       This style uses the Pkg option to find subs in a given package to call
       for each event.  If none of the subs that this style looks for is
       there, then the effect of parsing with this style is to print a
       canonical copy of the document without comments or declarations.  All
       the subs receive as their 1st parameter the Expat instance for the
       document they're parsing.

       It looks for the following routines:

       o   StartDocument

           Called at the start of the parse .

       o   StartTag

           Called for every start tag with a second parameter of the element
           type. The $_ variable will contain a copy of the tag and the %_
           variable will contain attribute values supplied for that element.

       o   EndTag

           Called for every end tag with a second parameter of the element
           type. The $_ variable will contain a copy of the end tag.

       o   Text

           Called just before start or end tags with accumulated non-markup
           text in the $_ variable.

       o   PI

           Called for processing instructions. The $_ variable will contain a
           copy of the PI and the target and data are sent as 2nd and 3rd
           parameters respectively.

       o   EndDocument

           Called at conclusion of the parse.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-------------------------------+
       |ATTRIBUTE TYPE |       ATTRIBUTE VALUE         |
       +---------------+-------------------------------+
       |Availability   | library/perl-5/xml-parser-532 |
       +---------------+-------------------------------+
       |Stability      | Volatile                      |
       +---------------+-------------------------------+

NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://search.cpan.org/CPAN/authors/id/T/TO/TODDR/XML-
       Parser-2.44.tar.gz.

       Further information about this software can be found on the open source
       community website at http://search.cpan.org/~toddr/.



perl v5.32.0                      2014-12-11          Parser::Style::Stream(3)