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
MacroIdfor this string's contents. -
#includes?(search : StringLiteral | CharLiteral) : BoolLiteral
Similar to
String#includes?. -
#lines : ArrayLiteral(StringLiteral)
Similar to
String#lines. -
#scan(regex : RegexLiteral) : ArrayLiteral(HashLiteral(NumberLiteral | StringLiteral), StringLiteral | NilLiteral)
Returns an array of capture hashes for each match of regex in this string.
-
#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
Returns an array of capture hashes for each match of regex in this string.
Capture hashes have the same form as Regex::MatchData#to_h.