Memory Package v0.1.0

The package provides raw memory management — allocating, resizing, and releasing blocks, and filling, copying, and comparing the bytes inside them.

Package: Memory

Source: github.com/rux-lang/Rux/tree/main/Packages/Memory

Every function is implemented per target, so a call compiles down to the platform's own primitives rather than to a bundled allocator: the Win32 heap and the Rtl* intrinsics on Windows, and anonymous mmap mappings on Linux and macOS. The API is the same on all of them.

import Memory::{ Alloc, Free, Set };
import Io::PrintLine;

func Main() -> int {
    let buffer = Alloc(1024);
    if buffer == null {
        return 1;
    }

    Set(buffer, 1024, 0xFF);
    PrintLine(*(buffer as *uint8)); // 255

    Free(buffer);
    return 0;
}

Installation

rux add Memory
rux install

Platform support

Implemented on BSD, Linux, macOS, and Windows.

Memory model

The block a caller receives is raw and owned: nothing tracks it, nothing frees it, and its contents are whatever the platform last left there. Alloc does not zero it — use Zero when you need a clean block. Every block returned by Alloc or Realloc must be released exactly once with Free, and a pointer that Realloc has moved must not be used again.

Passing a pointer these functions did not produce, releasing the same block twice, or reading or writing outside the requested size is undefined behavior — it is not checked and it will not be diagnosed.

Functions

Allocation

Filling

Bulk operations