dwww Home | Manual pages | Find package

Parser...:Stream(3pm) User Contributed Perl Documentation Parser...:Stream(3pm)

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:

       •   StartDocument

           Called at the start of the parse .

       •   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.

       •   EndTag

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

       •   Text

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

       •   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.

       •   EndDocument

           Called at conclusion of the parse.

perl v5.40.1                       2026-03-21             Parser...:Stream(3pm)

Generated by dwww version 1.16 on Sat Oct 3 06:00:43 CEST 2026.