class REXML::XPathParser
You don’t want to use this class. Really. Use XPath
, which is a wrapper for this class. Believe me. You don’t want to poke around in here. There is strange, dark magic at work in this code. Beware. Go back! Go back while you still can!
Constants
- DEBUG
- LITERAL
Public Class Methods
Source
# File lib/rexml/xpath_parser.rb, line 60 def initialize(strict: false) @debug = DEBUG @parser = REXML::Parsers::XPathParser.new @namespaces = nil @variables = {} @nest = 0 @strict = strict end
Public Instance Methods
Source
# File lib/rexml/xpath_parser.rb, line 102 def []=( variable_name, value ) @variables[ variable_name ] = value end
Source
# File lib/rexml/xpath_parser.rb, line 111 def first( path_stack, node ) return nil if path.size == 0 case path[0] when :document # do nothing return first( path[1..-1], node ) when :child for c in node.children r = first( path[1..-1], c ) return r if r end when :qname name = path[2] if node.name == name return node if path.size == 3 return first( path[3..-1], node ) else return nil end when :descendant_or_self r = first( path[1..-1], node ) return r if r for c in node.children r = first( path, c ) return r if r end when :node return first( path[1..-1], node ) when :any return first( path[1..-1], node ) end return nil end
Performs a depth-first (document order) XPath
search, and returns the first match. This is the fastest, lightest way to return a single result.
FIXME: This method is incomplete!
Source
# File lib/rexml/xpath_parser.rb, line 92 def get_first path, node path_stack = @parser.parse( path ) first( path_stack, node ) end
Source
# File lib/rexml/xpath_parser.rb, line 147 def match(path_stack, node) nodeset = [XPathNode.new(node, position: 1)] result = expr(path_stack, nodeset) case result when Array # nodeset unnode(result).uniq else [result] end end
Source
# File lib/rexml/xpath_parser.rb, line 69 def namespaces=( namespaces={} ) Functions::namespace_context = namespaces @namespaces = namespaces end
Source
# File lib/rexml/xpath_parser.rb, line 79 def parse path, node path_stack = @parser.parse( path ) if node.is_a?(Array) Kernel.warn("REXML::XPath.each, REXML::XPath.first, REXML::XPath.match dropped support for nodeset...", uplevel: 1) return [] if node.empty? node = node.first end node.document.__send__(:enable_cache) do match( path_stack, node ) end end
Source
# File lib/rexml/xpath_parser.rb, line 97 def predicate path, node path_stack = @parser.parse( path ) match( path_stack, node ) end
Source
# File lib/rexml/xpath_parser.rb, line 74 def variables=( vars={} ) Functions::variables = vars @variables = vars end