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
}

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/fmt.Format
use std/io

struct Point {
    x: i32
    y: i32
}

instance Point {
    impl Format
    method &self.try_format_into(output: &+String): void! {
        output.try_push_str("(")?
        self.x.try_format_into(output)?
        output.try_push_str(", ")?
        self.y.try_format_into(output)?
        output.try_push_str(")")?
        return
    }
}

blocking func main(): i32! {
    let point = Point { x: 3, y: 4 }
    let message = "point = ${point}\n"
    io.print(&message)?
    return 0
}

use std/io
use std/vec.Vec

struct Point {
    x: i32
    y: i32
}

instance Point {
    operator (&self == other: &Self): bool {
        return self.x == other.x && self.y == other.y
    }
}

blocking func main(): i32! {
    let first = Point { x: 3, y: 4 }
    let same = Point { x: 3, y: 4 }
    let other = Point { x: 5, y: 6 }
    if first != same || first == other {
        return 1
    }
    let points = Vec [move first, move other]
    if points[0] != same {
        return 1
    }
    var values = Vec [1, 2, 3]
    values[1] = 4
    if values[0] + values[1] + values[2] != 8 {
        return 1
    }
    io.print("equality found the point\n")?
    return 0
}

struct Buffer {
    values: [i32; 3]
}

instance Buffer {
    operator (&self[index: usize]): &i32 {
        return &self.values[index]
    }

    operator (&+self[index: usize]): &+i32 {
        return &+self.values[index]
    }
}

func at<C>(container: &C, index: usize): i32 where (&C[usize]): &i32 {
    return container[index]
}

func main(): i32 {
    var buffer = Buffer { values: [3, 4, 5] }
    buffer[1] = 9
    if at(&buffer, 1) != 9 {
        return 1
    }
    return 0
}

/std/io/stream/index.nct

index.nct

//! Lazy asynchronous byte-stream adapters.

use /io.Reader
use /io/buffer.BufReader
use /iter/asynchronous.AsyncIterator
use /string.String
use /vec.Vec
see ./chunks.nct
see ./lines.nct

/// Lazily reads independently owned, bounded byte chunks from a source.
pub struct ByteChunks<R>

construct ByteChunks<R> {
    /// Wraps `source` with the default positive chunk size.
    pub func new(source: R): Self where R impl Reader

    /// Wraps `source`, normalizing a zero requested chunk size to one byte.
    pub func with_chunk_size(source: R, requested_chunk_size: usize): Self where R impl Reader
}

instance ByteChunks<R> where R impl Reader {
    impl AsyncIterator { .Item = Vec<u8> }

    /// Consumes the adapter and returns its underlying source.
    pub method self.finish(): R
}

/// Lazily reads bounded, independently owned UTF-8 lines from a source.
pub struct Lines<R>

construct Lines<R> {
    /// Wraps `source` with the default read buffer and an explicit line bound.
    pub func new(source: R, maximum_encoded_line_bytes: usize): Self where R impl Reader

    /// Wraps `source` with explicit read-buffer and encoded-line bounds.
    pub func with_limits(
        source: R,
        requested_buffer_capacity: usize,
        maximum_encoded_line_bytes: usize,
    ): Self where R impl Reader
}

instance Lines<R> where R impl Reader {
    impl AsyncIterator { .Item = String }

    /// Consumes the adapter, discards buffered input, and returns its underlying source.
    pub method self.finish(): R
}