Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
BufferText(3)	      User Contributed Perl Documentation	 BufferText(3)

NAME
       XML::Filter::BufferText - Filter	to put all characters()	in one event

SYNOPSIS
	 my $h = SomeHandler->new;
	 my $f = XML::Filter::BufferText->new( Handler => $h );
	 my $p = SomeParser->new( Handler => $f	);
	 $p->parse;

DESCRIPTION
       This is a very simple filter. One common	cause of grief (and programmer
       error) is that XML parsers aren't required to provide character events
       in one chunk. They can, but are not forced to, and most don't. This
       filter does the trivial but oft-repeated	task of	putting	all characters
       into a single event.

       Note that this won't help you cases such	as:

	 <foo> blah <!-- comment --> phubar </foo>

       In the above case, given	the interleaving comment, there	will be	two
       "character()" events. This may be worked	around in the future if	there
       is demand for it.

       An interesting way to use this filter, instead of telling users to use
       it, is to return	it from	your handler's constructor, already configured
       and all.	 That'll make the buffering totally transparent	to them
       ("XML::SAX::Writer" does	that).

AUTHOR
       Robin Berjon, robin@knowscape.com

COPYRIGHT
       Copyright (c) 2001-2002 Robin Berjon. All rights	reserved. This program
       is free software; you can redistribute it and/or	modify it under	the
       same terms as Perl itself.

SEE ALSO
       XML::SAX::*, XML::Generator::*, XML::Handler::*,	XML::Filter::*

perl v5.32.1			  2003-07-04			 BufferText(3)

NAME | SYNOPSIS | DESCRIPTION | AUTHOR | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XML::Filter::BufferText&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help