Class: Markbridge::AST::Text

Inherits:
Node
  • Object
show all
Defined in:
lib/markbridge/ast/text.rb

Overview

Represents a text node (leaf node) in the AST. Text nodes contain the actual text content and cannot have children.

Examples:

Creating a text node

text = AST::Text.new("Hello, world!")

Merging text nodes

text1 = AST::Text.new("Hello")
text2 = AST::Text.new(" world")
text1.merge(text2)
text1.text # => "Hello world"

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(text) ⇒ Text

Create a new text node with the given content.

Frozen input is shared as-is (copy-on-write: #merge dups before its first append) — the parser hot path always passes frozen token text, so no copy is made per text node. Mutable input is copied so that in-place mutations cannot leak in either direction between the caller's string and this node.

Parameters:

  • text (String) —

    the text content



29
30
31
 
# File 'lib/markbridge/ast/text.rb', line 29

def initialize(text)
  @text = text.frozen? ? text : text.dup
end

Instance Attribute Details

#text ⇒ String (readonly)

Returns the text content of this node.

Returns:

  • (String) —

    the text content of this node



18
19
20
 
# File 'lib/markbridge/ast/text.rb', line 18

def text
  @text
end

Instance Method Details

#merge(other) ⇒ Text

Merge another text node's content into this one. This mutates the current text node by appending the other's text.

Parameters:

  • other (Text) —

    the text node to merge from

Returns:

  • (Text) —

    self for method chaining



38
39
40
41
42
 
# File 'lib/markbridge/ast/text.rb', line 38

def merge(other)
  @text = @text.dup if @text.frozen?
  @text << other.text
  self
end