Gecko [ www.jdcpatala.org ]

Name	Size	Permission
dtd	[ DIR ]	drwxr-xr-x
formatters	[ DIR ]	drwxr-xr-x
light	[ DIR ]	drwxr-xr-x
parsers	[ DIR ]	drwxr-xr-x
validation	[ DIR ]	drwxr-xr-x
attlistdecl.rb	1.92 KB	-rw-r--r--
attribute.rb	5.97 KB	-rw-r--r--
cdata.rb	1.59 KB	-rw-r--r--
child.rb	2.66 KB	-rw-r--r--
comment.rb	2.12 KB	-rw-r--r--
doctype.rb	7.97 KB	-rw-r--r--
document.rb	9.55 KB	-rw-r--r--
element.rb	44 KB	-rw-r--r--
encoding.rb	1.16 KB	-rw-r--r--
entity.rb	5.4 KB	-rw-r--r--
functions.rb	12.27 KB	-rw-r--r--
instruction.rb	2.14 KB	-rw-r--r--
namespace.rb	1.4 KB	-rw-r--r--
node.rb	2.18 KB	-rw-r--r--
output.rb	553 B	-rw-r--r--
parent.rb	4.27 KB	-rw-r--r--
parseexception.rb	1.25 KB	-rw-r--r--
quickpath.rb	9.12 KB	-rw-r--r--
rexml.rb	1.29 KB	-rw-r--r--
sax2listener.rb	3.61 KB	-rw-r--r--
security.rb	824 B	-rw-r--r--
source.rb	6.75 KB	-rw-r--r--
streamlistener.rb	3.84 KB	-rw-r--r--
text.rb	14.57 KB	-rw-r--r--
undefinednamespaceexception.rb	244 B	-rw-r--r--
xmldecl.rb	2.95 KB	-rw-r--r--
xmltokens.rb	2.32 KB	-rw-r--r--
xpath.rb	3.42 KB	-rw-r--r--
xpath_parser.rb	29.63 KB	-rw-r--r--

Code Editor : xpath.rb

# frozen_string_literal: false
require_relative 'functions'
require_relative 'xpath_parser'

module REXML
  # Wrapper class.  Use this class to access the XPath functions.
  class XPath
    include Functions
    # A base Hash object, supposing to be used when initializing a
    # default empty namespaces set, but is currently unused.
    # TODO: either set the namespaces=EMPTY_HASH, or deprecate this.
    EMPTY_HASH = {}

# 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.
    # 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.first( node )
    #  XPath.first( doc, "//b"} )
    #  XPath.first( node, "a/x:b", { "x"=>"http://doofus" } )
    #  XPath.first( node, '/book/publisher/text()=$publisher', {}, {"publisher"=>"O'Reilly"})
    def XPath::first(element, path=nil, namespaces=nil, variables={}, options={})
      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(**options)
      parser.namespaces = namespaces
      parser.variables = variables
      path = "*" unless path
      element = [element] unless element.kind_of? Array
      parser.parse(path, element).flatten[0]
    end

# 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| ... }
    def XPath::each(element, path=nil, namespaces=nil, variables={}, options={}, &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(**options)
      parser.namespaces = namespaces
      parser.variables = variables
      path = "*" unless path
      element = [element] unless element.kind_of? Array
      parser.parse(path, element).each( &block )
    end

# Returns an array of nodes matching a given XPath.
    def XPath::match(element, path=nil, namespaces=nil, variables={}, options={})
      parser = XPathParser.new(**options)
      parser.namespaces = namespaces
      parser.variables = variables
      path = "*" unless path
      element = [element] unless element.kind_of? Array
      parser.parse(path,element)
    end
  end
end

${this.title}

Code Editor : xpath.rb