xml::grove::sub(3) [redhat man page]

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

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.8.0							    1999-09-02							XML::Grove::Sub(3)

XML::Grove::Path(3)					User Contributed Perl Documentation				       XML::Grove::Path(3)

NAME

       XML::Grove::Path - return the object at a path

SYNOPSIS

	use XML::Grove::Path;

	# Using at_path method on XML::Grove::Document or XML::Grove::Element:
	$xml_obj = $grove_object->at_path("/some/path");

	# Using an XML::Grove::Path instance:
	$pather = XML::Grove::Path->new();
	$xml_obj = $pather->at_path($grove_object);

DESCRIPTION

       "XML::Grove::Path" returns XML objects located at paths.  Paths are strings of element names or XML object types seperated by slash ("/")
       characters.  Paths must always start at the grove object passed to `"at_path()"'.  "XML::Grove::Path" is not XPath, but it should become
       obsolete when an XPath implementation is available.

       Paths are like URLs

	   /html/body/ul/li[4]
	   /html/body/#pi[2]

       The path segments can be element names or object types, the objects types are named using:

	   #element
	   #pi
	   #comment
	   #text
	   #cdata
	   #any

       The `"#any"' object type matches any type of object, it is essentially an index into the contents of the parent object.

       The `"#text"' object type treats text objects as if they are not normalized.  Two consecutive text objects are seperate text objects.

AUTHOR

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

SEE ALSO

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

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

perl v5.16.3							    1999-08-17						       XML::Grove::Path(3)