Variáveis
O Tyrus fornece duas palavras-chave para declaração de bindings: const e let. Ambas impõem escopo léxico estrito e participam da checagem estática de tipos, mas diferem em mutabilidade, regras de reatribuição e requisitos de inicialização.
const vs let
A escolha entre const e let estabelece se um binding e seus dados subjacentes podem sofrer mutações.
| Recurso | const | let |
|---|---|---|
| Reatribuição | Proibida em tempo de compilação | Permitida |
| Imutabilidade profunda | Aplicada recursivamente a objetos e arrays | Não aplicada (propriedades e elementos são mutáveis) |
| Inicializador obrigatório | Sempre obrigatório | Opcional (let x: i32; é permitido) |
| Shadowing | Proibido | Proibido |
Bindings imutáveis com const
const declara um binding imutável cujo valor não pode ser reatribuído após a inicialização. Use const por padrão sempre que uma variável não exigir reatribuição.
const maxRetries: i32 = 3;
const appName: string = "tyrus";
print(maxRetries); // 3
print(appName); // tyrusTentar atribuir um novo valor a um binding const gera erro em tempo de compilação.
error
const maxRetries: i32 = 3;
maxRetries = 5; error[E0384]: cannot assign to immutable variable `maxRetries`
at /src/main.tyr:3:1
maxRetries = 5;
^^^^^^^^^^
help: declare `maxRetries` with `let` to allow assignmentImutabilidade profunda com const
No Tyrus, const garante imutabilidade profunda. No Tyrus proíbe modificar propriedades de objetos ou elementos de arrays declarados com const.
const numbers: i32[] = [1, 2, 3];
print(numbers[0]); // 1
print(numbers.length); // 3Modificar um campo de objeto ou elemento de array através de uma referência const é rejeitado pelo compilador.
error
const numbers: i32[] = [1, 2, 3];
numbers[0] = 99; error[E0384]: cannot assign through immutable `numbers`
at /src/main.tyr:3:1
numbers[0] = 99;
^^^^^^^
help: declare `numbers` with `let` to allow assignmentBindings mutáveis com let
let declara um binding mutável. Ele permite tanto a reatribuição da variável quanto a mutação in-place de estruturas compostas como arrays e objetos.
let counter: i32 = 0;
counter = 1;
counter += 2;
print(counter); // 3
let scores: i32[] = [10, 20, 30];
scores[0] = 95;
print(scores[0]); // 95A reatribuição deve continuar respeitando o tipo estaticamente declarado ou inferido da variável.
error
let counter: i32 = 0;
counter = "two"; error[E0308]: type mismatch for `counter`: expected `i32`, found `string`
at /src/main.tyr:3:11
counter = "two";
^^^^^
help: change the value or the annotation so their types matchBindings let sem inicializador
Uma variável declarada com let pode ser declarada sem um inicializador imediato, mesmo para tipos não opcionais como let number: i32;. Bindings opcionais (T?) iniciam vazios e podem ser inspecionados com segurança via coalescência nula (??), enquanto bindings não opcionais devem ser atribuídos antes de serem lidos.
let total: i32;
total = 100;
print(total); // 100
let status: string?;
print(status ?? "ready"); // readyLer uma variável não opcional não inicializada antes da atribuição é um erro, e declarar um const sem inicializador é proibido.
error
let total: i32;
print(total); error[E0381]: `total` is used before being assigned a value
at /src/main.tyr:3:7
print(total);
^^^^^
help: assign a value to `total` before reading itShadowing não é permitido
O Tyrus não permite shadowing de variáveis no mesmo escopo. Para atualizar um valor, declare uma vinculação mutável com let e faça a reatribuição em vez de redeclarar a variável.
let count: i32 = 1;
count = 2;
print(count); // 2Tentar redeclarar uma variável com let ou const no mesmo escopo é rejeitado pelo compilador.
error
let count: i32 = 1;
let count: i32 = 2; error[E0428]: identifier `count` is declared more than once in this scope
at /src/main.tyr:3:5
let count: i32 = 2;
^^^^^
related: previous declaration of `count` is here
at /src/main.tyr:1:5
let count: i32 = 1;
^^^^^Inferência de tipos e anotações
Os tipos das variáveis podem ser anotados explicitamente ou inferidos automaticamente a partir da expressão do inicializador.
const timeout: u32 = 5000;
let endpoint = "/api/v1";
print(timeout); // 5000
print(endpoint); // /api/v1Quando uma anotação de tipo explícita é fornecida, o valor atribuído deve atender à restrição desse tipo.
error
const timeout: u32 = "5000"; error[E0308]: type mismatch for `timeout`: expected `u32`, found `string`
at /src/main.tyr:1:7
const timeout: u32 = "5000";
^^^^^^^
help: change the value or the annotation so their types match; convert numbers explicitly with `value as <type>`