Class: Prism::RegularExpressionNode
Relationships & Source Files | |
Super Chains via Extension / Inclusion / Inheritance | |
Class Chain:
self,
Node
|
|
Instance Chain:
self,
RegularExpressionOptions ,
Node
|
|
Inherits: |
Prism::Node
|
Defined in: | lib/prism/node.rb, lib/prism/node_ext.rb |
Overview
Represents a regular expression literal with no interpolation.
/foo/i
^^^^^^
Class Method Summary
- .new(flags, opening_loc, content_loc, closing_loc, unescaped, location) ⇒ RegularExpressionNode constructor
-
.type
Similar to #type, this method returns a symbol that you can use for splitting on the type of the node without having to do a long === chain.
Instance Attribute Summary
-
#ascii_8bit? ⇒ Boolean
readonly
def ascii_8bit?: () -> bool.
-
#closing_loc
readonly
attr_reader closing_loc:
Location
. -
#content_loc
readonly
attr_reader content_loc:
Location
. -
#euc_jp? ⇒ Boolean
readonly
def euc_jp?: () -> bool.
-
#extended? ⇒ Boolean
readonly
def extended?: () -> bool.
- #flags readonly
-
#forced_binary_encoding? ⇒ Boolean
readonly
def forced_binary_encoding?: () -> bool.
-
#forced_us_ascii_encoding? ⇒ Boolean
readonly
def forced_us_ascii_encoding?: () -> bool.
-
#forced_utf8_encoding? ⇒ Boolean
readonly
def forced_utf8_encoding?: () -> bool.
-
#ignore_case? ⇒ Boolean
readonly
def ignore_case?: () -> bool.
-
#multi_line? ⇒ Boolean
readonly
def multi_line?: () -> bool.
-
#once? ⇒ Boolean
readonly
def once?: () -> bool.
-
#opening_loc
readonly
attr_reader opening_loc:
Location
. -
#unescaped
readonly
attr_reader unescaped: String.
-
#utf_8? ⇒ Boolean
readonly
def utf_8?: () -> bool.
-
#windows_31j? ⇒ Boolean
readonly
def windows_31j?: () -> bool.
Node
- Inherited
Instance Method Summary
-
#accept(visitor)
def accept: (visitor:
Visitor
) -> void. -
#child_nodes
(also: #deconstruct)
def child_nodes: () -> Array[nil | Node].
-
#closing
def closing: () -> String.
-
#comment_targets
def comment_targets: () -> Array[Node | Location].
-
#compact_child_nodes
def compact_child_nodes: () -> Array.
-
#content
def content: () -> String.
-
#copy(**params)
def copy: (**params) ->
RegularExpressionNode
. -
#deconstruct
Alias for #child_nodes.
- #deconstruct_keys(keys)
-
#inspect(inspector = NodeInspector.new)
def inspect(inspector: NodeInspector) -> String.
-
#opening
def opening: () -> String.
-
#type
Sometimes you want to check an instance of a node against a list of classes to see what kind of behavior to perform.
RegularExpressionOptions
- Included
#options | Returns a numeric value that represents the flags that were used to create the regular expression. |
Node
- Inherited
#pretty_print | Similar to inspect, but respects the current level of indentation given by the pretty print object. |
#slice | Slice the location of the node from the source. |
#to_dot | Convert this node into a graphviz dot graph string. |
#deprecated, #newline!, #set_newline_flag |
Constructor Details
.new(flags, opening_loc, content_loc, closing_loc, unescaped, location) ⇒ RegularExpressionNode
# File 'lib/prism/node.rb', line 14305
def initialize(flags, opening_loc, content_loc, closing_loc, unescaped, location) @flags = flags @opening_loc = opening_loc @content_loc = content_loc @closing_loc = closing_loc @unescaped = unescaped @location = location end
Class Method Details
.type
Similar to #type, this method returns a symbol that you can use for splitting on the type of the node without having to do a long === chain. Note that like #type, it will still be slower than using == for a single class, but should be faster in a case statement or an array comparison.
def self.type: () -> Symbol
# File 'lib/prism/node.rb', line 14460
def self.type :regular_expression_node end
Instance Attribute Details
#ascii_8bit? ⇒ Boolean
(readonly)
def ascii_8bit?: () -> bool
# File 'lib/prism/node.rb', line 14380
def ascii_8bit? flags.anybits?(RegularExpressionFlags::ASCII_8BIT) end
#closing_loc (readonly)
attr_reader closing_loc: Location
# File 'lib/prism/node.rb', line 14299
attr_reader :closing_loc
#content_loc (readonly)
attr_reader content_loc: Location
# File 'lib/prism/node.rb', line 14296
attr_reader :content_loc
#euc_jp? ⇒ Boolean
(readonly)
def euc_jp?: () -> bool
# File 'lib/prism/node.rb', line 14375
def euc_jp? flags.anybits?(RegularExpressionFlags::EUC_JP) end
#extended? ⇒ Boolean
(readonly)
def extended?: () -> bool
# File 'lib/prism/node.rb', line 14360
def extended? flags.anybits?(RegularExpressionFlags::EXTENDED) end
#flags (readonly)
[ GitHub ]# File 'lib/prism/node.rb', line 14290
private attr_reader :flags
#forced_binary_encoding? ⇒ Boolean
(readonly)
def forced_binary_encoding?: () -> bool
# File 'lib/prism/node.rb', line 14400
def forced_binary_encoding? flags.anybits?(RegularExpressionFlags::FORCED_BINARY_ENCODING) end
#forced_us_ascii_encoding? ⇒ Boolean
(readonly)
def forced_us_ascii_encoding?: () -> bool
# File 'lib/prism/node.rb', line 14405
def forced_us_ascii_encoding? flags.anybits?(RegularExpressionFlags::FORCED_US_ASCII_ENCODING) end
#forced_utf8_encoding? ⇒ Boolean
(readonly)
def forced_utf8_encoding?: () -> bool
# File 'lib/prism/node.rb', line 14395
def forced_utf8_encoding? flags.anybits?(RegularExpressionFlags::FORCED_UTF8_ENCODING) end
#ignore_case? ⇒ Boolean
(readonly)
def ignore_case?: () -> bool
# File 'lib/prism/node.rb', line 14355
def ignore_case? flags.anybits?(RegularExpressionFlags::IGNORE_CASE) end
#multi_line? ⇒ Boolean
(readonly)
def multi_line?: () -> bool
# File 'lib/prism/node.rb', line 14365
def multi_line? flags.anybits?(RegularExpressionFlags::MULTI_LINE) end
#once? ⇒ Boolean
(readonly)
def once?: () -> bool
# File 'lib/prism/node.rb', line 14370
def once? flags.anybits?(RegularExpressionFlags::ONCE) end
#opening_loc (readonly)
attr_reader opening_loc: Location
# File 'lib/prism/node.rb', line 14293
attr_reader :opening_loc
#unescaped (readonly)
attr_reader unescaped: String
# File 'lib/prism/node.rb', line 14302
attr_reader :unescaped
#utf_8? ⇒ Boolean
(readonly)
def utf_8?: () -> bool
# File 'lib/prism/node.rb', line 14390
def utf_8? flags.anybits?(RegularExpressionFlags::UTF_8) end
#windows_31j? ⇒ Boolean
(readonly)
def windows_31j?: () -> bool
# File 'lib/prism/node.rb', line 14385
def windows_31j? flags.anybits?(RegularExpressionFlags::WINDOWS_31J) end
Instance Method Details
#accept(visitor)
def accept: (visitor: Visitor
) -> void
# File 'lib/prism/node.rb', line 14315
def accept(visitor) visitor.visit_regular_expression_node(self) end
#child_nodes Also known as: #deconstruct
def child_nodes: () -> Array[nil | Node]
# File 'lib/prism/node.rb', line 14320
def child_nodes [] end
#closing
def closing: () -> String
# File 'lib/prism/node.rb', line 14420
def closing closing_loc.slice end
#comment_targets
def comment_targets: () -> Array[Node | Location]
# File 'lib/prism/node.rb', line 14330
def comment_targets [opening_loc, content_loc, closing_loc] end
#compact_child_nodes
def compact_child_nodes: () -> Array
# File 'lib/prism/node.rb', line 14325
def compact_child_nodes [] end
#content
def content: () -> String
# File 'lib/prism/node.rb', line 14415
def content content_loc.slice end
#copy(**params)
def copy: (**params) -> RegularExpressionNode
# File 'lib/prism/node.rb', line 14335
def copy(**params) RegularExpressionNode.new( params.fetch(:flags) { flags }, params.fetch(:opening_loc) { opening_loc }, params.fetch(:content_loc) { content_loc }, params.fetch(:closing_loc) { closing_loc }, params.fetch(:unescaped) { unescaped }, params.fetch(:location) { location }, ) end
#deconstruct
Alias for #child_nodes.
# File 'lib/prism/node.rb', line 14347
alias deconstruct child_nodes
#deconstruct_keys(keys)
# File 'lib/prism/node.rb', line 14350
def deconstruct_keys(keys) { flags: flags, opening_loc: opening_loc, content_loc: content_loc, closing_loc: closing_loc, unescaped: unescaped, location: location } end
#inspect(inspector = NodeInspector.new)
def inspect(inspector: NodeInspector) -> String
# File 'lib/prism/node.rb', line 14425
def inspect(inspector = NodeInspector.new) inspector << inspector.header(self) flags = [("ignore_case" if ignore_case?), ("extended" if extended?), ("multi_line" if multi_line?), ("once" if once?), ("euc_jp" if euc_jp?), ("ascii_8bit" if ascii_8bit?), ("windows_31j" if windows_31j?), ("utf_8" if utf_8?), ("forced_utf8_encoding" if forced_utf8_encoding?), ("forced_binary_encoding" if forced_binary_encoding?), ("forced_us_ascii_encoding" if forced_us_ascii_encoding?)].compact inspector << "├── flags: #{flags.empty? ? "∅" : flags.join(", ")}\n" inspector << "├── opening_loc: #{inspector.location(opening_loc)}\n" inspector << "├── content_loc: #{inspector.location(content_loc)}\n" inspector << "├── closing_loc: #{inspector.location(closing_loc)}\n" inspector << "└── unescaped: #{unescaped.inspect}\n" inspector.to_str end
#opening
def opening: () -> String
# File 'lib/prism/node.rb', line 14410
def opening opening_loc.slice end
#type
Sometimes you want to check an instance of a node against a list of classes to see what kind of behavior to perform. Usually this is done by calling [cls1, cls2].include?(node.class)
or putting the node into a case statement and doing case node; when cls1; when cls2; end
. Both of these approaches are relatively slow because of the constant lookups, method calls, and/or array allocations.
Instead, you can call #type
, which will return to you a symbol that you can use for comparison. This is faster than the other approaches because it uses a single integer comparison, but also because if you’re on CRuby you can take advantage of the fact that case statements with all symbol keys will use a jump table.
def type: () -> Symbol
# File 'lib/prism/node.rb', line 14450
def type :regular_expression_node end