Programming Language

Nocter

A self-contained systems language built around simplicity, encapsulation, and foolproof design.

Specification GitHub

use std/io

blocking func main(): i32! {
    io.print("Hello from Nocter\n")?
    return 0
}

use std/io
use std/vec.Vec

struct Counter {
    value: i32
}

blocking func main(): i32! {
    var counters = Vec [Counter { value: 1 }, Counter { value: 2 }, Counter { value: 3 }]
    for counter in &+counters {
        counter.value += 10
    }

    var borrowed_total: i32 = 0
    for counter in &counters {
        borrowed_total += counter.value
    }

    var moved_total: i32 = 0
    for counter in move counters {
        moved_total += counter.value
    }

    let message = "borrowed: ${borrowed_total}, moved: ${moved_total}\n"
    io.print(&message)?
    return 0
}

func main(): i32 {
    let value = load_value() catch failure { fallback_for(failure.message()) }
    if value == 42 {
        return 0
    }
    return 1
}

func load_value(): i32! {
    return error.new("example.unavailable", "the primary value is unavailable")
}

func fallback_for(message: &str): i32 {
    return 42
}

use std/task
use std/time
use std/time.Duration

async func delayed(value: i32): i32 {
    await time.sleep(Duration.from_milliseconds(1))
    return value
}

async func main(): i32! {
    let (left, right) = await task.join(delayed(20), delayed(22))
    if left + right != 42 {
        return error.new("example.unexpected_total", "joined tasks returned the wrong total")
    }
    return 0
}

use std/io
use std/url.Url

blocking func main(): i32! {
    let url = Url.parse("HTTP://Example.COM:80/a/../status?q=ready#fragment")?
    let canonical = url.to_string()
    let authority = url.authority()
    let target = url.request_target()
    io.println(&canonical)?
    io.println(&authority)?
    io.println(&target)?
    return 0
}

Universally Unique Identifiers

The compiler-checked std/uuid contract owns UUID byte layout and canonical text. Uuid is a copyable value containing exactly 16 bytes. Parsing accepts exactly 36 lowercase ASCII characters with hyphens in the 8-4-4-4-12 positions; formatting always returns that spelling. Equality, ordering, hashing, byte observation, parsing, and formatting derive from the same stored bytes.

Uuid.v4() fills all 16 bytes through std/random, then sets the RFC 9562 version-4 and RFC 4122 variant bits. It is allocation-free and returns std.random.unavailable if the operating-system entropy source fails. The supported Darwin entropy provider is a bounded system call and is not a blocking operation in Nocter's effect model.

Random UUIDs provide practical opaque identifiers. They are not secret tokens, authentication credentials, signatures, or proof that two independently supplied identifiers are globally unique.