# XML::Grove::Path - phpMan

## 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>>