Skip to content

Tuples ​

Native tuple operations ​

OperationBehavior
lengthRead-only compile-time tuple length.
tuple[index]Reads or writes an element using an integer literal index; the element type is determined by that position.
DestructuringExtracts tuple elements into local bindings; _ discards an element.
Mutating array methodsMethods that change elements or length are rejected because a tuple has a fixed layout.

Methods that return a new array can be used where their signatures accept a sequence; see Array.

tyrus
const point: [f64, f64] = [3.0, 4.0];
const [x, y] = point;
const pair: [i32, string] = [1, "one"];
const namedPair: Tuple<i32, string> = [1, "one"];

const parseStatus = (): [i32, string] => [200, "ok"];
const [statusCode, _] = parseStatus();
print(statusCode); // 200

Tuples lower to native structs, while arrays are dynamic collections. Tuple indexes must be integer literals, so out-of-range access is a compile error.

A wildcard _ in a destructuring position discards that element: it is still extracted and released like any other local, but declares no name the rest of the scope can read back, so a later _ in the same pattern never collides with an earlier one. Reading _ afterward is an ordinary undeclared-identifier error, the same as any other name that was never declared.