Type Reference

Built-in types

Type

C representation

Description

int

long long (64-bit signed)

Integer arithmetic; default numeric type

float64

double (64-bit IEEE-754)

Floating-point arithmetic

bool

long long (internally 0 or 1)

Logical values; truthiness

string

Heap-allocated NativeString (UTF-8 bytes)

Length-prefixed; supports concatenation and indexing

array

NativeArray (Value** items)

Dynamic array; [val, ...] literal

map

{} string-keyed

Associative map (string keys only)

struct

Tagged map instances

User-defined record types (C-layout records are tracked work, S-0; today field storage is map-based — see Memory Model)

enum

Tagged variant (payload recorded, matched on tag)

Algebraic data type; patterns are EnumName.Variant (no payload binding)

Option / Result

Tagged wrappers (Some/None, Ok/Err)

Presence and fallible results; match must be exhaustive (no null, no exceptions)

*T / &T / &mut T

Raw C pointer / borrow / mutable borrow

Unsafe and ownership-checked access (borrow checker, escape analysis)

bigint / bigfloat

GMP-backed arbitrary precision

Linked with -lgmp; arbitrary-size integers and floats

matrix

Continuous row-major 2D array (AVX2-optimized)

matrix Name[rows, cols] of float64

Type inference

let and var declarations infer the type from the right-hand side:

let x = 42          // int
let pi = 3.14       // float64
let msg = "hello"   // string
let flag = true     // bool
let arr = [1, 2, 3] // array

Typed declarations

Explicit type annotations follow a colon:

let y: float64 = 3.14
var count: int = 0

The annotation must be compatible with the initializer. A mismatch produces a diagnostic (K112 — primitive annotation/initializer mismatch).

Conversion functions

float() converts a value to float64. Supported inputs:

Input type

Behavior

int

Integer-to-float promotion

float64

Identity (no-op)

string

Parse string as float

bool

true → 1.0, false → 0.0

let x: float64 = float(42)     // 42.0
let y: float64 = float("3.14") // 3.14
let z: float64 = float(true)   // 1.0