Struct SyncBumpArena 

pub struct SyncBumpArena { /* private fields */ }

A thread-safe bump arena allocator implementing allocator-api2’s Allocator trait.

Holds an Arc<Mutex<SyncBumpInner>> so it is Clone + Send + Sync + 'static. All clones share the same arena — when the last clone drops, all memory is freed at once (the chunks’ Vec drop returns memory to the global allocator).

See the module-level documentation for the full design rationale and safety model.

Implementations

impl SyncBumpArena

pub fn new() -> Self

Creates a new SyncBumpArena with no initial capacity.

The first allocation will trigger a 4 KiB chunk allocation.

pub fn with_capacity(capacity: usize) -> Self

Creates a new SyncBumpArena with an initial chunk of the given size.

This avoids a growth step on the first allocations if the approximate total size is known in advance.

Trait Implementations

impl Allocator for SyncBumpArena

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

Attempts to allocate a block of memory.

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

Deallocates the memory referenced by ptr.

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

Behaves like allocate, but also ensures that the returned memory is zero-initialized.

unsafe fn grow( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<[u8]>, AllocError>

Attempts to extend the memory block.

unsafe fn grow_zeroed( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<[u8]>, AllocError>

Behaves like grow, but also ensures that the new contents are set to zero before being returned.

unsafe fn shrink( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<[u8]>, AllocError>

Attempts to shrink the memory block.

fn by_ref(&self) -> &Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Allocator.

impl Clone for SyncBumpArena

fn clone(&self) -> SyncBumpArena

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SyncBumpArena

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

Formats the value using the given formatter.

impl Default for SyncBumpArena

fn default() -> Self

Returns the “default value” for a type.