Struct BufferAllocatorRef 

pub struct BufferAllocatorRef(/* private fields */);

A shared reference to a buffer allocator.

The static allocator does not need shared ownership, so it is stored without an Arc. This makes cloning the common static allocator a simple value copy.

Implementations

impl BufferAllocatorRef

pub fn new(allocator: impl BufferAllocator) -> Self

Wrap an allocator in a shared reference.

pub fn statically_allocated() -> Self

Return a shared reference to the static allocator.

pub fn static_ref() -> &'static Self

Return a borrowed reference to the static allocator.

pub fn ptr_eq(&self, other: &Self) -> bool

Returns true if both references point to the same allocator.

pub fn with_capacity<T>(&self, capacity: usize) -> BufferMut<T>

Create a mutable buffer with this allocator.

pub fn with_capacity_aligned<T>( &self, capacity: usize, alignment: Alignment, ) -> BufferMut<T>

Create an aligned mutable buffer with this allocator.

pub fn zeroed<T>(&self, len: usize) -> BufferMut<T>

Create a zeroed mutable buffer with this allocator.

pub fn copy_from<T>(&self, values: impl AsRef<[T]>) -> BufferMut<T>

Copy values into a mutable buffer made by this allocator.

Trait Implementations

impl Allocator for BufferAllocatorRef

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

Attempts to allocate a block of memory.

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 deallocate(&self, ptr: NonNull<u8>, layout: Layout)

Deallocates the memory referenced by ptr.

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 BufferAllocatorRef

fn clone(&self) -> BufferAllocatorRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BufferAllocatorRef

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

Formats the value using the given formatter.