Skip to main content

SharedBumpArena

Struct SharedBumpArena 

Source
pub struct SharedBumpArena<B: FixedRange> { /* private fields */ }
Expand description

Atomic-cursor bump arena.

Sound under multi-thread &self allocation: the cursor uses a compare_exchange_weak CAS loop to handle alignment rounding atomically.

Implementations§

Source§

impl<B: FixedRange> SharedBumpArena<B>

Source

pub fn new(backing: B) -> Result<Self, AllocError>

Construct a shared bump arena.

Errors if the backing reports a zero-byte range.

Source

pub fn allocated(&self) -> usize

Bytes currently allocated.

Source

pub fn capacity(&self) -> usize

Total capacity in bytes.

Source

pub fn remaining(&self) -> usize

Bytes remaining.

Trait Implementations§

Source§

impl<B: FixedRange> Allocator for SharedBumpArena<B>

Source§

fn allocate(&self, layout: NonZeroLayout) -> Result<NonNull<[u8]>, AllocError>

Allocate a block satisfying layout. The returned slice’s length is at least layout.size() but may be larger.
Source§

fn capacity_bytes(&self) -> Option<usize>

Total bytes this allocator can issue, if bounded. None for unbounded allocators like System. Used by Watermark to compute thresholds.
Source§

fn allocate_zeroed( &self, layout: NonZeroLayout, ) -> Result<NonNull<[u8]>, AllocError>

Allocate a zero-initialized block.
Source§

unsafe fn grow( &self, ptr: NonNull<u8>, old: NonZeroLayout, new: NonZeroLayout, ) -> Result<NonNull<[u8]>, AllocError>

Grow an allocation in place if possible, otherwise allocate-copy-free. Read more
Source§

unsafe fn shrink( &self, ptr: NonNull<u8>, old: NonZeroLayout, new: NonZeroLayout, ) -> Result<NonNull<[u8]>, AllocError>

Shrink an allocation in place if possible, otherwise allocate-copy-free. Read more
Source§

fn reset(&mut self) -> Result<(), AllocError>

Reclaim everything previously allocated. Default impl returns AllocError — only arena-style allocators implement a meaningful reset. Read more
Source§

unsafe fn usable_size( &self, _ptr: NonNull<u8>, _layout: NonZeroLayout, ) -> Option<usize>

Usable size of an existing allocation, if the allocator can report it. Defaults to None — implementors that track usable size override. Read more
Source§

fn corruption_events(&self) -> u64

Detected freelist / metadata corruption events observed by this allocator since construction. Read more
Source§

impl<B: FixedRange> Deallocator for SharedBumpArena<B>

Source§

unsafe fn deallocate(&self, _ptr: NonNull<u8>, _layout: NonZeroLayout)

Release a previously allocated block. Read more
Source§

impl<B: FixedRange> FixedRange for SharedBumpArena<B>

Source§

fn base(&self) -> NonNull<u8>

First byte of the owned address range. Read more
Source§

fn size(&self) -> usize

Length in bytes of the owned address range. Read more
Source§

fn commit(&self, offset: usize, len: usize) -> Result<(), AllocError>

Ensure the bytes [offset, offset + len) (relative to base) are backed by committed, writable memory before a consumer writes through them. Read more
Source§

fn contains(&self, ptr: NonNull<u8>) -> bool

Whether ptr lies within [base, base + size). Read more
Source§

impl<B: FixedRange + Send> Send for SharedBumpArena<B>

Source§

impl<B: FixedRange + Send> Sync for SharedBumpArena<B>

Auto Trait Implementations§

§

impl<B> !Freeze for SharedBumpArena<B>

§

impl<B> RefUnwindSafe for SharedBumpArena<B>
where B: RefUnwindSafe,

§

impl<B> Unpin for SharedBumpArena<B>
where B: Unpin,

§

impl<B> UnsafeUnpin for SharedBumpArena<B>
where B: UnsafeUnpin,

§

impl<B> UnwindSafe for SharedBumpArena<B>
where B: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.