XML::Grove::Path.3pm

Langue: en

Version: 2010-02-10 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

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 separated 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 separate 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>