FM / rexml

/opt/cpanel/ea-ruby27/root/usr/share/ruby/ruby-2.7.8/rexml/

/opt/cpanel/ea-ruby27/root/usr/share/ruby/ruby-2.7.8/rexml

Name	Size	Mode	Actions
dtd/	-	0755	rm
formatters/	-	0755	rm
light/	-	0755	rm
parsers/	-	0755	rm
validation/	-	0755	rm
attlistdecl.rb	1970	0644	edit dl rm
attribute.rb	6117	0644	edit dl rm
cdata.rb	1624	0644	edit dl rm
child.rb	2725	0644	edit dl rm
comment.rb	2170	0644	edit dl rm
doctype.rb	8160	0644	edit dl rm
document.rb	9779	0644	edit dl rm
element.rb	45598	0644	edit dl rm
encoding.rb	1183	0644	edit dl rm
entity.rb	5531	0644	edit dl rm
functions.rb	12567	0644	edit dl rm
instruction.rb	2191	0644	edit dl rm
namespace.rb	1436	0644	edit dl rm
node.rb	2236	0644	edit dl rm
output.rb	553	0644	edit dl rm
parent.rb	4375	0644	edit dl rm
parseexception.rb	1283	0644	edit dl rm
quickpath.rb	9341	0644	edit dl rm
rexml.rb	1319	0644	edit dl rm
sax2listener.rb	3693	0644	edit dl rm
security.rb	824	0644	edit dl rm
source.rb	7901	0644	edit dl rm
streamlistener.rb	3932	0644	edit dl rm
text.rb	14212	0644	edit dl rm
undefinednamespaceexception.rb	244	0644	edit dl rm
xmldecl.rb	3019	0644	edit dl rm
xmltokens.rb	2380	0644	edit dl rm
xpath.rb	3501	0644	edit dl rm
xpath_parser.rb	30346	0644	edit dl rm

Edit: /opt/cpanel/ea-ruby27/root/usr/share/ruby/ruby-2.7.8/rexml/xpath.rb (3501B)

# 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

cmd: