From: Ilya M. <m_...@us...> - 2003-04-30 20:45:21
|
Update of /cvsroot/perl-xml/XML-LibXML-XPathContext In directory sc8-pr-cvs1:/tmp/cvs-serv5228 Modified Files: README Log Message: Updated Index: README =================================================================== RCS file: /cvsroot/perl-xml/XML-LibXML-XPathContext/README,v retrieving revision 1.3 retrieving revision 1.4 diff -u -d -r1.3 -r1.4 --- README 4 Apr 2003 09:05:48 -0000 1.3 +++ README 30 Apr 2003 20:45:15 -0000 1.4 @@ -21,9 +21,13 @@ $xc->unregisterVarLookupFunc($name); my @nodes = $xc->findnodes($xpath); + my @nodes = $xc->findnodes($xpath, $context_node); my $nodelist = $xc->findnodes($xpath); + my $nodelist = $xc->findnodes($xpath, $context_node); my $result = $xc->find($xpath); + my $result = $xc->find($xpath, $context_node); my $value = $xc->findvalue($xpath); + my $value = $xc->findvalue($xpath, $context_node); DESCRIPTION This module augments XML::LibXML by providing Perl interface to @@ -88,7 +92,7 @@ ); # get names of employees from $A woring in an area listed in $B - $xc->registerVarLookupFunc(\&var_lookup,\%results); + $xc->registerVarLookupFunc(\&var_lookup, \%results); my @nodes = $xc->findnodes('$A[work_area/street = $B]/name'); METHODS @@ -146,12 +150,13 @@ unregisterFunction($name) Same as *unregisterFunctionNS* but without a namespace. - findnodes($xpath) + findnodes($xpath, [ $context_node ]) Performs the xpath statement on the current node and returns the result as an array. In scalar context returns a - XML::LibXML::NodeList object. + XML::LibXML::NodeList object. Optionally, a node may be passed as a + second argument to set the context node for the query. - find($xpath) + find($xpath, [ $context_node ]) Performs the xpath expression using the current node as the context of the expression, and returns the result depending on what type of result the XPath expression had. For example, the XPath "1 * 3 + 52" @@ -159,9 +164,10 @@ expressions might return a XML::LibXML::Boolean object, or a XML::LibXML::Literal object (a string). Each of those objects uses Perl's overload feature to "do the right thing" in different - contexts. + contexts. Optionally, a node may be passed as a second argument to + set the context node for the query. - findvalue($xpath) + findvalue($xpath, [ $context_node ]) Is exactly equivalent to: $node->find( $xpath )->to_literal; @@ -169,7 +175,8 @@ That is, it returns the literal value of the results. This enables you to ensure that you get a string back from your search, allowing certain shortcuts. This could be used as the equivalent of - <xsl:value-of select="some_xpath"/>. + <xsl:value-of select="some_xpath"/>. Optionally, a node may be + passed in the second argument to set the context node for the query. getContextNode() Get the current context node. |