Struct Arena 

pub struct Arena { /* private fields */ }

A bump allocator for row data.

Memory is allocated in contiguous chunks. Each alloc call bumps a pointer forward. There is no per-allocation deallocation — the entire arena is freed at once via reset() or Drop.

Example

use bsql_arena::Arena;

let mut arena = Arena::new();
let offset = arena.alloc_copy(b"hello");
assert_eq!(arena.get(offset, 5), b"hello");
arena.reset();

Implementations

impl Arena

pub fn new() -> Arena

Create a new arena with an 8KB initial chunk.

pub fn empty() -> Arena

Create an empty arena with zero allocation.

No memory is allocated until alloc or alloc_copy is called. Used by query paths that store data in QueryResult.data_buf instead.

pub fn alloc(&mut self, len: usize) -> &mut [u8]

Allocate len bytes, returning a mutable slice into the arena.

The returned slice is zeroed. For copying data in, prefer alloc_copy.

pub fn alloc_copy(&mut self, data: &[u8]) -> usize

Copy data into the arena and return the global offset.

The offset can be used with get() to retrieve the data later.

pub fn get(&self, global_offset: usize, len: usize) -> &[u8]

Retrieve a slice from the arena by global offset and length.

Panics

Panics if the offset + length exceeds the arena’s allocated range.

pub fn get_str(&self, global_offset: usize, len: usize) -> Option<&str>

Retrieve a str slice from the arena. Returns None if not valid UTF-8.

Uses SIMD-accelerated UTF-8 validation via simdutf8.

pub fn reset(&mut self)

Reset the arena for reuse. Keeps allocated memory but resets the bump pointer.

Chunks larger than 64KB are discarded to prevent long-term bloat.

pub fn allocated(&self) -> usize

Total bytes allocated in this arena (across all chunks).

pub fn capacity(&self) -> usize

Total capacity of all chunks (for diagnostics).

pub fn global_offset(&self) -> usize

Compute the global offset for the current position.

Trait Implementations

impl Default for Arena

fn default() -> Arena

Returns the “default value” for a type.