Struct Locked

pub struct Locked<A> { /* private fields */ }

A wrapper around a spin::Mutex to provide safe, locked access to the inner allocator. The Locked type ensures that only one thread can access the allocator at a time.

Implementations

impl<A> Locked<A>

pub const fn new(inner: A) -> Self

Creates a new Locked instance with the provided inner value.

Arguments

• inner - The value to be wrapped in the Locked mutex.

Returns

A Locked instance containing the provided value.

pub fn lock(&self) -> MutexGuard<'_, A>

Locks the inner mutex and returns a guard for accessing the wrapped value.

Returns

A MutexGuard that allows mutable access to the wrapped value.

Trait Implementations

impl GlobalAlloc for Locked<BumpAllocator>

unsafe fn alloc(&self, layout: Layout) -> *mut u8

Allocates a memory block with the specified layout.

Safety

This function must be used in a single-threaded environment or protected by a lock.

unsafe fn dealloc(&self, _ptr: *mut u8, _layout: Layout)

Deallocates a memory block. Since this is a bump allocator, deallocation is only meaningful when all allocations are freed at once.

Safety

The provided pointer must be valid and previously allocated.

unsafe fn alloc_zeroed(&self, layout: Layout) -> *mut u8

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

unsafe fn realloc( &self, ptr: *mut u8, layout: Layout, new_size: usize, ) -> *mut u8

Shrinks or grows a block of memory to the given new_size in bytes. The block is described by the given ptr pointer and layout.

impl GlobalAlloc for Locked<FixedSizeBlockAllocator>

unsafe fn alloc(&self, layout: Layout) -> *mut u8

Allocates memory with the requested layout.

Safety

This function must be called only in a thread-safe context.

unsafe fn dealloc(&self, ptr: *mut u8, layout: Layout)

Deallocates memory and inserts it back into the free list if applicable.

Safety

The provided pointer must be valid and previously allocated.

unsafe fn alloc_zeroed(&self, layout: Layout) -> *mut u8

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

unsafe fn realloc( &self, ptr: *mut u8, layout: Layout, new_size: usize, ) -> *mut u8

Shrinks or grows a block of memory to the given new_size in bytes. The block is described by the given ptr pointer and layout.

impl GlobalAlloc for Locked<LinkedListAllocator>

Implements the global allocator trait for LinkedListAllocator.

unsafe fn alloc(&self, layout: Layout) -> *mut u8

Allocates a memory block with the given layout.

Safety

The caller must ensure that the requested allocation is valid and does not cause undefined behavior.

unsafe fn dealloc(&self, ptr: *mut u8, layout: Layout)

Deallocates a previously allocated memory block.

Safety

The caller must ensure that the pointer and layout are valid and that the memory block was allocated by this allocator.

unsafe fn alloc_zeroed(&self, layout: Layout) -> *mut u8

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

unsafe fn realloc( &self, ptr: *mut u8, layout: Layout, new_size: usize, ) -> *mut u8

Shrinks or grows a block of memory to the given new_size in bytes. The block is described by the given ptr pointer and layout.