Struct TalcLock 

pub struct TalcLock<R: RawMutex, S: Source, B: Binning> { /* private fields */ }

Wraps a mutex-locked Talc.

Example

use spinning_top::RawSpinlock;

let talc = talc::TalcLock::<RawSpinlock, _>::new(Manual);

Implementations

impl<R: RawMutex, S: Source, B: Binning> TalcLock<R, S, B>

pub const fn new(source: S) -> Self

Create a new TalcLock.

pub fn lock(&self) -> MutexGuard<'_, R, Talc<S, B>>

Lock the mutex and access the inner Talc.

pub fn try_lock(&self) -> Option<MutexGuard<'_, R, Talc<S, B>>>

Try to lock the mutex and access the inner Talc.

pub fn get_mut(&mut self) -> &mut Talc<S, B>

Returns a mutable reference to the inner Talc.

This avoids locking, as having a mutable reference statically guarantees that self is not locked.

pub fn into_inner(self) -> Talc<S, B>

Retrieve the inner Talc.

Trait Implementations

impl<R: RawMutex, S: Source, B: Binning> Allocator for TalcLock<R, S, B>

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.

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.

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 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<R: Debug + RawMutex, S: Debug + Source, B: Debug + Binning> Debug for TalcLock<R, S, B>

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

Formats the value using the given formatter.

impl<R: RawMutex, S: Source, B: Binning> GlobalAlloc for TalcLock<R, S, B>

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

Allocates memory as described by the given layout.

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

Deallocates the block of memory at the given ptr pointer with the given layout.

unsafe fn realloc( &self, ptr: *mut u8, old_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.

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.