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

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

NAME

       XML::Grove::IDs - return an index of `id' attributes in a grove

SYNOPSIS

	use XML::Grove::IDs;

	# Using get_ids method on XML::Grove::Document or XML::Grove::Element:
	$hash = $grove_object->get_ids($attr_name, $elements);

	# Using an XML::Grove::IDs instance:
	$indexer = XML::Grove::IDs->new($attr_name, $elements);
	my $hash = {};
	$grove_object->accept($indexer, $hash);

DESCRIPTION

       "XML::Grove::IDs" returns a hash index of all nodes in a grove with an `id' attribute.  The keys of the hash are the ID attribute value and
       the value at that key is the element.  `$attr_name' and `$elements' are optional.  The attribute name defaults to `"id"' if `$attr_name' is
       not supplied.  Indexing can be restricted to only certain elements, by name, by providing a hash containing NAME=>1 values.

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-08-17							XML::Grove::IDs(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)