class Macros::MacroId

Overview

A ficticious node representing an idenfitifer like, foo, Bar or something_else.

The parser doesn't create this nodes. Instead, you create them by invoking #id on some nodes. For example, invoking #id on a StringLiteral returns a MacroId for the string's content. Similarly, invoking ID on a SymbolLiteral, Call, Var and Path return MacroIds for the node's content.

This allows you to treat strings, symbols, variables and calls unifomly. For example:

macro getter(name)
  def {{name.id}}
    @{{name.id}}
  end
end

getter unicorns
getter :unicorns
getter "unicorns"

All of the above macro calls work because we invoked #id, and the generated code looks like this:

def unicorns
  @unicorns
end

If we hand't use #id, the generated code would have been this:

def unicorns
  @unicorns
end

def :unicorns
  @:unicorns
end

def "unicorns"
  @"unicorns"
end

The last two definitions are invalid and so will give a compile-time error.

Superclass hierarchy

Defined in:

Instance Method Summary

• #+(other : StringLiteral | CharLiteral) : MacroId

  Similar to String#+.

• #=~(range : RegexLiteral) : BoolLiteral

  Similar to String#=~.

• #[](range : RangeLiteral) : MacroId

  Similar to String#[].

• #capitalize : MacroId

  Similar to String#capitalize.

• #chars : ArrayLiteral(CharLiteral)

  Similar to String#chars.

• #chomp : MacroId

  Similar to String#chomp.

• #downcase : MacroId

  Similar to String#downcase.

• #empty? : BoolLiteral

  Similar to String#empty?.

• #ends_with?(other : StringLiteral | CharLiteral) : BoolLiteral

  Similar to String#ends_with?.

• #gsub(regex : RegexLiteral, replacement : StringLiteral) : MacroId

  Similar to String#gsub.

• #id : MacroId

  Returns self.

• #length : NumberLiteral

  Similar to String#length.

• #lines : ArrayLiteral(StringLiteral)

  Similar to String#lines.

• #split : ArrayLiteral(StringLiteral)

  Similar to String#split.

• #split(node : ASTNode) : ArrayLiteral(StringLiteral)

  Similar to String#split.

• #starts_with?(other : StringLiteral | CharLiteral) : BoolLiteral

  Similar to String#starts_with?.

• #strip : MacroId

  Similar to String#strip.

• #tr(from : StringLiteral, to : StringLiteral) : MacroId

  Similar to String#tr.

• #upcase : MacroId

  Similar to String#upcase.

Instance Method Detail