1XML::Grove::Path(3)   User Contributed Perl Documentation  XML::Grove::Path(3)
2
3
4

NAME

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

SYNOPSIS

9        use XML::Grove::Path;
10
11        # Using at_path method on XML::Grove::Document or XML::Grove::Element:
12        $xml_obj = $grove_object->at_path("/some/path");
13
14        # Using an XML::Grove::Path instance:
15        $pather = XML::Grove::Path->new();
16        $xml_obj = $pather->at_path($grove_object);
17

DESCRIPTION

19       "XML::Grove::Path" returns XML objects located at paths.  Paths are
20       strings of element names or XML object types seperated by slash ("/")
21       characters.  Paths must always start at the grove object passed to
22       `"at_path()"'.  "XML::Grove::Path" is not XPath, but it should become
23       obsolete when an XPath implementation is available.
24
25       Paths are like URLs
26
27           /html/body/ul/li[4]
28           /html/body/#pi[2]
29
30       The path segments can be element names or object types, the objects
31       types are named using:
32
33           #element
34           #pi
35           #comment
36           #text
37           #cdata
38           #any
39
40       The `"#any"' object type matches any type of object, it is essentially
41       an index into the contents of the parent object.
42
43       The `"#text"' object type treats text objects as if they are not
44       normalized.  Two consecutive text objects are seperate text objects.
45

AUTHOR

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

SEE ALSO

50       perl(1), XML::Grove(3)
51
52       Extensible Markup Language (XML) <http://www.w3c.org/XML>
53
54
55
56perl v5.16.3                      1999-08-17               XML::Grove::Path(3)