class Crystal::Macros::MacroId
Overview
A fictitious node representing an identifier like, foo
, Bar
or something_else
.
The parser doesn't create these 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
returns a MacroId for the node's content.
This allows you to treat strings, symbols, variables and calls uniformly. 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 hadn't used #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.
Defined in:
compiler/crystal/macros.crInstance Method Summary
-
#+(other : StringLiteral | CharLiteral) : MacroId
Similar to
String#+
. -
#<(other : StringLiteral | MacroId) : BoolLiteral
Similar to
String#<
-
#=~(range : RegexLiteral) : BoolLiteral
Similar to
String#=~
. -
#>(other : StringLiteral | MacroId) : BoolLiteral
Similar to
String#>
-
#[](range : RangeLiteral) : MacroId
Similar to
String#[]
. -
#camelcase(*, lower : BoolLiteral = false) : MacroId
Similar to
String#camelcase
. -
#capitalize : MacroId
Similar to
String#capitalize
. -
#chars : ArrayLiteral(CharLiteral)
Similar to
String#chars
. -
#chomp : MacroId
Similar to
String#chomp
. -
#count(other : CharLiteral) : NumberLiteral
Similar to
String#count
. -
#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 a
MacroId
for this string's contents. -
#includes?(search : StringLiteral | CharLiteral) : BoolLiteral
Similar to
String#includes?
. -
#lines : ArrayLiteral(StringLiteral)
Similar to
String#lines
. -
#size : NumberLiteral
Similar to
String#size
. -
#split(node : ASTNode) : ArrayLiteral(StringLiteral)
Similar to
String#split
. -
#split : ArrayLiteral(StringLiteral)
Similar to
String#split
. -
#starts_with?(other : StringLiteral | CharLiteral) : BoolLiteral
Similar to
String#starts_with?
. -
#strip : MacroId
Similar to
String#strip
. -
#titleize : MacroId
Similar to
String#titleize
. -
#to_i(base = 10)
Similar to
String#to_i
. -
#tr(from : StringLiteral, to : StringLiteral) : MacroId
Similar to
String#tr
. -
#underscore : MacroId
Similar to
String#underscore
. -
#upcase : MacroId
Similar to
String#upcase
.
Instance methods inherited from class Crystal::Macros::ASTNode
!=(other : ASTNode) : BoolLiteral
!=,
==(other : ASTNode) : BoolLiteral
==,
class_name : StringLiteral
class_name,
column_number : StringLiteral | NilLiteral
column_number,
doc : StringLiteral
doc,
doc_comment : MacroId
doc_comment,
end_column_number : StringLiteral | NilLiteral
end_column_number,
end_line_number : StringLiteral | NilLiteral
end_line_number,
filename : StringLiteral | NilLiteral
filename,
id : MacroId
id,
is_a?(type : TypeNode) : BoolLiteral
is_a?,
line_number : StringLiteral | NilLiteral
line_number,
nil? : BoolLiteral
nil?,
raise(message) : NoReturn
raise,
stringify : StringLiteral
stringify,
symbolize : SymbolLiteral
symbolize,
warning(message : StringLiteral) : NilLiteral
warning
Instance Method Detail
Similar to String#camelcase
.
Similar to String#ends_with?
.
Similar to String#gsub
.
Similar to String#includes?
.
Similar to String#starts_with?
.