AllocationError

Classifies recoverable raw-storage and layout failures.

Sn is under heavy development. Reference extracted from this release’s bundled standard library. Public API examples are not an exhaustive compatibility test. Read the matching release guide for tested workflows and limitations. Read the status →

Module std.memory

import std.memory;

Public declaration contracts and authored examples. A page can document several related symbols. Implementation bodies are excluded.

AllocationError

pub enum AllocationError

Classifies recoverable raw-storage and layout failures.

The cases are portable and allocation-free. They intentionally preserve no target allocator status code; target-private adapters translate at their boundary.

Example

module example.allocation_error;
from std.memory import AllocationError, Layout;
fn Main() -> i32 {
    switch Layout.ArrayOf<u64>(4) {
        case .Ok { Value = _ } => return 0;
        case .Err { Error = Error } => {
            if Error == .SizeOverflow { return 2; }
            return 1;
        }
    }
}

AllocationError.OutOfMemory

OutOfMemory;

Reports that the allocator could not acquire storage.

AllocationError.UnsupportedAlignment

UnsupportedAlignment;

Reports that the allocator cannot honor a valid requested alignment.

AllocationError.InvalidLayout

InvalidLayout;

Reports a zero, non-power-of-two, or otherwise invalid layout.

AllocationError.SizeOverflow

SizeOverflow;

Reports that a requested byte-count computation is not representable.

Documentation snapshot: October 24, 2026 About versions ↗