Variables
Create a variable #
The first assignment creates a variable. Its type comes from the value.
def main() -> Void
name = "Ana"
age = 25
puts("#{name} is #{age}")
endAna is 25Update a variable #
A later assignment changes the value, not the type. +=, -=, *=, /= and %= are short forms, and the variable must already exist.
def main() -> Void
count = 1
count = count + 1
count += 10
puts(count)
end12def main() -> Void
count = 1
count = "one" # error: count is an Int
enderror[CHECK-TYPE-MISMATCH]Type annotations #
Write the type when the value does not show it, such as an empty list.
def main() -> Void
total: Float = 0.5
names: List[String] = []
names = names.push("Ana")
puts(total)
puts(names)
end0.5
["Ana"]Discard with _ #
_ is a discard wherever a name is bound: an assignment, a for variable, a block or function parameter, or a pattern slot. It binds nothing, can repeat and never conflicts. Reading it is CHECK-UNKNOWN-NAME.
def load(n: Int) -> Int
puts("load #{n}")
n
end
def main() -> Void
_ = load(1) # keep the call, drop its value
for _ in 1..2 # the body does not need the number
puts("tick")
end
{"a": 1, "b": 2}.each do |_, v| # drop the key
puts(v)
end
case Result.Ok(3)
ok(_) -> puts("fine") # drop the payload
error(_) -> puts("failed")
end
endload 1
tick
tick
1
2
finedef main() -> Void
_ = 1
puts(_) # error: _ cannot be read
enderror[CHECK-UNKNOWN-NAME]_: Int = x is PARSE-UNEXPECTED-TOKEN, _ = puts("x") is CHECK-VOID-VALUE and _ += 1 is CHECK-UNKNOWN-NAME.
Unused variables #
A variable that is never read is an error (CHECK-UNUSED-VARIABLE): remove it, or start its name with _ when it is unused on purpose. The same holds for a for variable, a block parameter and a name in a case pattern; use _ there as above. A function parameter is never reported, since callers depend on the signature.
Updating a variable does not read it: count += 1 alone leaves count unused. A variable that is assigned twice and read once is fine.
def main() -> Void
total = 0
count = 0 # error: count is only updated, never read
for n in [1, 2]
total += n
count += 1
end
puts(total)
enderror[CHECK-UNUSED-VARIABLE]def main() -> Void
_count = 0 # kept on purpose
puts("ok")
endokScope #
A variable made inside a block (if, while, for, …) is gone after its end. Create it before the block to use it after.
def main() -> Void
message = "small"
n = 12
if n > 10
message = "big"
end
puts(message)
endbigThere is no shadowing: a new variable cannot reuse a visible name.
def main() -> Void
x = 1
for x in [1, 2] # error: x is already visible
puts(x)
end
enderror[CHECK-SHADOWED-NAME]Names #
Variable, function and field names start with a lowercase letter or _. Type names start with an uppercase letter. a = b = 1 is not allowed.