xml::grove::ascanonxml(3pm) [debian man page]

XML::Grove::AsCanonXML(3pm)				User Contributed Perl Documentation			       XML::Grove::AsCanonXML(3pm)

NAME

       XML::Grove::AsCanonXML - output XML objects in canonical XML

SYNOPSIS

	use XML::Grove::AsCanonXML;

	# Using as_canon_xml method on XML::Grove objects:
	$string = $xml_object->as_canon_xml( OPTIONS );

	# Using an XML::Grove::AsCanonXML instance:
	$writer = XML::Grove::AsCanonXML->new( OPTIONS );

	$string = $writer->as_canon_xml($xml_object);
	$writer->as_canon_xml($xml_object, $file_handle);

DESCRIPTION

       "XML::Grove::AsCanonXML" will return a string or write a stream of canonical XML for an XML object and it's content (if any).

       "XML::Grove::AsCanonXML" objects hold the options used for writing the XML objects.  Options can be supplied when the the object is
       created,

	   $writer = XML::Grove::AsCanonXML->new( Comments => 1 );

       or modified at any time before writing an XML object by setting the option directly in the `$writer' hash.

OPTIONS

       Comments
	   By default comments are not written to the output.  Setting comment to TRUE will include comments in the output.

AUTHOR

       Ken MacLeod, ken@bitsko.slc.ut.us

SEE ALSO

       perl(1), XML::Parser(3), XML::Grove(3).

       James Clark's Canonical XML definition <http://www.jclark.com/xml/canonxml.html>

perl v5.10.1							    1999-10-23					       XML::Grove::AsCanonXML(3pm)

XML::Grove::Sub(3pm)					User Contributed Perl Documentation				      XML::Grove::Sub(3pm)

NAME

       XML::Grove::Sub - run a filter sub over a grove

SYNOPSIS

	use XML::Grove::Sub;

	# Using filter method on XML::Grove::Document or XML::Grove::Element:
	@results = $grove_object->filter(&sub [, ...]);

	# Using an XML::Grove::Sub instance:
	$filterer = XML::Grove::Sub->new();
	@results = $grove_object->accept($filterer, &sub [, ...]);

DESCRIPTION

       "XML::Grove::Sub" executes a sub, the filter, over all objects in a grove and returns a list of all the return values from the sub.  The
       sub is called with the grove object as it's first parameter and passing the rest of the arguments to the call to `"filter()"' or
       `"accept()"'.

EXAMPLE

       The following filter will return a list of all `"foo"' or `"bar"' elements with an attribute `"widget-no"' beginning with `"A"' or `"B"'.

	 @results = $grove_obj->filter(sub {
	     my $obj = shift;

	     if ($obj->isa('XML::Grove::Element')
		 && (($obj->{Name} eq 'foo')
		     || ($obj->{Name} eq 'bar'))
		 && ($obj->{Attributes}{'widget-no'} =~ /^[AB]/)) {
		 return ($obj);
	     }
	     return ();
	 });

AUTHOR

       Ken MacLeod, ken@bitsko.slc.ut.us

SEE ALSO

       perl(1), XML::Grove(3), Data::Grove::Visitor(3)

       Extensible Markup Language (XML) <http://www.w3c.org/XML>

perl v5.10.1							    1999-10-23						      XML::Grove::Sub(3pm)