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>

perl v5.36.0                                       2022-11-29                              XML::Grove::Path(3pm)