Represents the use of the => operator.
foo => bar ^^^^^^^^^^
Represents the right-hand side of the operator. The type of the node depends on the expression.
Anything that looks like a local variable name (including _) will result in a LocalVariableTargetNode.
foo => a # This is equivalent to writing `a = foo`
^
Using an explicit Array or combining expressions with , will result in a ArrayPatternNode. This can be preceded by a constant.
foo => [a]
^^^
foo => a, b
^^^^
foo => Bar[a, b]
^^^^^^^^^
If the array pattern contains at least two wildcard matches, a FindPatternNode is created instead.
foo => *, 1, *a
^^^^^
Using an explicit Hash or a constant with square brackets and hash keys in the square brackets will result in a HashPatternNode.
foo => { a: 1, b: } foo => Bar[a: 1, b:] foo => Bar[**]
To use any variable that needs run time evaluation, pinning is required. This results in a PinnedVariableNode
foo => ^a
^^
Similar, any expression can be used with pinning. This results in a PinnedExpressionNode.
foo => ^(a + 1)
Anything else will result in the regular node for that expression, for example a ConstantReadNode.
foo => CONST
Represents the left-hand side of the operator.
foo => bar ^^^
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12780
def initialize(source, node_id, location, flags, value, pattern, operator_loc)
@source = source
@node_id = node_id
@location = location
@flags = flags
@value = value
@pattern = pattern
@operator_loc = operator_loc
end
Initialize a new MatchRequiredNode node.
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12906
def self.type
:match_required_node
end
Return a symbol representation of this node type. See Node::type.
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12912
def ===(other)
other.is_a?(MatchRequiredNode) &&
(value === other.value) &&
(pattern === other.pattern) &&
(operator_loc.nil? == other.operator_loc.nil?)
end
Implements case-equality for the node. This is effectively == but without comparing the value of locations. Locations are checked only for presence.
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12791
def accept(visitor)
visitor.visit_match_required_node(self)
end
def accept: (Visitor visitor) -> void
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12796
def child_nodes
[value, pattern]
end
def child_nodes: () -> Array
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12806
def comment_targets
[value, pattern, operator_loc] #: Array[Prism::node | Location]
end
def comment_targets: () -> Array[Node | Location]
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12801
def compact_child_nodes
[value, pattern]
end
def compact_child_nodes: () -> Array
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12811
def copy(node_id: self.node_id, location: self.location, flags: self.flags, value: self.value, pattern: self.pattern, operator_loc: self.operator_loc)
MatchRequiredNode.new(source, node_id, location, flags, value, pattern, operator_loc)
end
def copy: (?node_id: Integer, ?location: Location, ?flags: Integer, ?value: Prism::node, ?pattern: Prism::node, ?operator_loc: Location) -> MatchRequiredNode
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12819
def deconstruct_keys(keys)
{ node_id: node_id, location: location, value: value, pattern: pattern, operator_loc: operator_loc }
end
def deconstruct_keys: (Array keys) -> { node_id: Integer, location: Location, value: Prism::node, pattern: Prism::node, operator_loc: Location }
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12896
def inspect
InspectVisitor.compose(self)
end
def inspect -> String
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12891
def operator
operator_loc.slice
end
def operator: () -> String
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12878
def operator_loc
location = @operator_loc
return location if location.is_a?(Location)
@operator_loc = Location.new(source, location >> 32, location & 0xFFFFFFFF)
end
The location of the operator.
foo => bar
^^
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12886
def save_operator_loc(repository)
repository.enter(node_id, :operator_loc)
end
Save the operator_loc location using the given saved source so that it can be retrieved later.
# File tmp/rubies/ruby-4.0.0/lib/prism/node.rb, line 12901
def type
:match_required_node
end
Return a symbol representation of this node type. See Node#type.