Skip to content

Variables ​

Tyrus proporciona dos palabras clave para la declaración de bindings: const y let. Ambas imponen un ámbito léxico estricto y participan en la comprobación estática de tipos, pero difieren en mutabilidad, reglas de reasignación y requisitos de inicialización.

const vs let ​

La elección entre const y let establece si un binding y sus datos subyacentes pueden modificarse.

Característicaconstlet
ReasignaciónProhibida en tiempo de compilaciónPermitida
Inmutabilidad profundaAplicada recursivamente en objetos y arraysNo aplicada (las propiedades y elementos son mutables)
Inicializador obligatorioSiempre obligatorioOpcional (let x: i32; está permitido)
ShadowingProhibidoProhibido

Bindings inmutables con const ​

const declara un binding inmutable cuyo valor no se puede reasignar después de su inicialización. Utiliza const por defecto siempre que una variable no requiera reasignación.

tyrus
const maxRetries: i32 = 3;
const appName: string = "tyrus";

print(maxRetries); // 3
print(appName); // tyrus

Intentar asignar un nuevo valor a un binding const produce un error en tiempo de compilación.

error

tyrus
const maxRetries: i32 = 3;

maxRetries = 5; 
text
error[E0384]: cannot assign to immutable variable `maxRetries`
at /src/main.tyr:3:1
maxRetries = 5;
^^^^^^^^^^
help: declare `maxRetries` with `let` to allow assignment

Inmutabilidad profunda con const ​

En Tyrus, const garantiza una inmutabilidad profunda. En Tyrus prohíbe modificar las propiedades de un objeto o los elementos de un array declarados con const.

tyrus
const numbers: i32[] = [1, 2, 3];

print(numbers[0]); // 1
print(numbers.length); // 3

Modificar un campo de objeto o elemento de array a través de una referencia const es rechazado por el compilador.

error

tyrus
const numbers: i32[] = [1, 2, 3];

numbers[0] = 99; 
text
error[E0384]: cannot assign through immutable `numbers`
at /src/main.tyr:3:1
numbers[0] = 99;
^^^^^^^
help: declare `numbers` with `let` to allow assignment

Bindings mutables con let ​

let declara un binding mutable. Permite tanto la reasignación de la variable como la mutación in situ de estructuras compuestas como arrays y objetos.

tyrus
let counter: i32 = 0;
counter = 1;
counter += 2;
print(counter); // 3

let scores: i32[] = [10, 20, 30];
scores[0] = 95;
print(scores[0]); // 95

La reasignación debe seguir respetando el tipo declarado estáticamente o inferido de la variable.

error

tyrus
let counter: i32 = 0;

counter = "two"; 
text
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 match

Bindings let sin inicializador ​

Una variable declarada con let puede declararse sin un inicializador inmediato, incluso para tipos no opcionales como let number: i32;. Los bindings opcionales (T?) comienzan vacíos y se pueden evaluar de forma segura con coalescencia nula (??), mientras que los bindings no opcionales deben asignarse antes de poder leerse.

tyrus
let total: i32;
total = 100;
print(total); // 100

let status: string?;
print(status ?? "ready"); // ready

Leer una variable no opcional sin inicializar antes de la asignación es un error, y declarar un const sin inicializador está prohibido.

error

tyrus
let total: i32;

print(total); 
text
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 it

Shadowing no permitido ​

Tyrus no permite el shadowing de variables en el mismo ámbito. Para actualizar un valor, declare una vinculación mutable con let y realice una reasignación en lugar de volver a declarar la variable.

tyrus
let count: i32 = 1;
count = 2;

print(count); // 2

Intentar volver a declarar una variable con let o const en el mismo ámbito es rechazado por el compilador.

error

tyrus
let count: i32 = 1;

let count: i32 = 2; 
text
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;
    ^^^^^

Inferencia de tipos y anotaciones ​

Los tipos de las variables pueden anotarse explícitamente o inferirse automáticamente a partir de la expresión del inicializador.

tyrus
const timeout: u32 = 5000;
let endpoint = "/api/v1";

print(timeout); // 5000
print(endpoint); // /api/v1

Cuando se proporciona una anotación de tipo explícita, el valor asignado debe satisfacer la restricción de dicho tipo.

error

tyrus
const timeout: u32 = "5000"; 
text
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>`