Class: REXML::XPath

Class REXML::XPath |
In: | rexml/xpath.rb
Parent: | Object

Wrapper class. Use this class to access the XPath functions.

Methods

each first match

Included modules

Functions

Public Class methods

first(element, path=nil, namespaces=nil)

Finds and returns the first node that matches the supplied xpath.

element: | The context element
path: | The xpath to search for. If not supplied or nil, returns the first node matching '*'.
namespaces: | If supplied, a Hash which defines a namespace mapping.

     XPath.first( node )
     XPath.first( doc, "//b"} )
     XPath.first( node, "a/x:b", { "x"=>"http://doofus" } )

each(element, path=nil, namespaces=nil, &block)

Itterates over nodes that match the given path, calling the supplied block with the match.

element: | The context element
path: | The xpath to search for. If not supplied or nil, defaults to '*'
namespaces: | If supplied, a Hash which defines a namespace mapping

     XPath.each( node ) { |el| ... }
     XPath.each( node, '/*[@attr='v']' ) { |el| ... }
     XPath.each( node, 'ancestor::x' ) { |el| ... }

match(element, path=nil, namespaces=nil)

Returns an array of nodes matching a given XPath.