Struct MemoryTracker 

pub struct MemoryTracker { /* private fields */ }

Tracks memory allocations against a per-query budget.

Thread-safe via atomic operations — can be shared across parallel query operators via Arc<MemoryTracker>.

Implementations

impl MemoryTracker

pub fn new(budget_bytes: usize) -> Self

Create a new tracker with the given memory budget in bytes.

pub fn try_allocate(&self, bytes: usize) -> Result<()>

Try to allocate bytes from the budget.

Returns Ok(()) if the allocation succeeds, or QueryError::QueryMemoryExceeded if the budget would be exceeded.

Errors

Returns an error if allocated + bytes > budget.

pub fn deallocate(&self, bytes: usize)

Release bytes back to the budget.

Panics

Debug-asserts that bytes does not exceed the current allocation.

pub fn allocated(&self) -> usize

Returns the current number of allocated bytes.

pub fn budget(&self) -> usize

Returns the configured budget in bytes.

pub fn remaining(&self) -> usize

Returns the number of bytes remaining before the budget is exhausted.

Trait Implementations

impl Debug for MemoryTracker

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.