method

each

v2_5_5 - Show latest stable - 0 notes - Class: REXML::XPath

each(element, path=nil, namespaces=nil, variables={}) public

Iterates 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
variables	If supplied, a Hash which maps $variables in the query to values. This can be used to avoid XPath injection attacks or to automatically handle escaping string values.

XPath.each( node ) { |el| ... }
XPath.each( node, '/*[@attr='v']' ) { |el| ... }
XPath.each( node, 'ancestor::x' ) { |el| ... }
XPath.each( node, '/book/publisher/text()=$publisher', {}, {"publisher"=>"O'Reilly"}) \
  {|el| ... }

Show source

# File lib/rexml/xpath.rb, line 60
    def XPath::each element, path=nil, namespaces=nil, variables={}, &block
      raise "The namespaces argument, if supplied, must be a hash object." unless namespaces.nil? or namespaces.kind_of?(Hash)
      raise "The variables argument, if supplied, must be a hash object." unless variables.kind_of?(Hash)
      parser = XPathParser.new
      parser.namespaces = namespaces
      parser.variables = variables
      path = "*" unless path
      element = [element] unless element.kind_of? Array
      parser.parse(path, element).each( &block )
    end

each

Related methods