Trait Realloc 

pub trait Realloc: Grow + Shrink {
    // Provided methods
    unsafe fn realloc(
        &self,
        ptr: NonNull<u8>,
        old_layout: Layout,
        new_layout: Layout,
    ) -> Result<NonNull<u8>, Self::Error> { ... }
    unsafe fn rezalloc(
        &self,
        ptr: NonNull<u8>,
        old_layout: Layout,
        new_layout: Layout,
    ) -> Result<NonNull<u8>, Self::Error> { ... }
}

A memory allocation interface which can arbitrarily resize allocations.

Provided Methods

unsafe fn realloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

Reallocates a block, growing or shrinking as needed.

On grow, preserves existing contents up to old_layout.size(), and on shrink, truncates to new_layout.size().

On failure, the original memory will not be deallocated.

Returns a dangling pointer if layout.size() == 0.

Safety

The caller must ensure:

• ptr points to a block previously allocated with this allocator.
• old_layout describes exactly the same block.

Errors

Errors are implementation-defined, refer to [Self::Error] and Error.

The standard implementations may return:

• Err(Error::AllocFailed(layout, cause)) if allocation fails. cause is typically Cause::Unknown. If the os_err_reporting feature is enabled, it will be Cause::OSErr. In this case, oserr will be the error from IOErr::last_os_error.raw_os_error().

unsafe fn rezalloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

Reallocates a block, growing or shrinking as needed, with extra bytes being zeroed.

On grow, preserves existing contents up to old_layout.size(), and on shrink, truncates to new_layout.size().

On failure, the original memory will not be deallocated.

Returns a dangling pointer if layout.size() == 0.

Safety

The caller must ensure:

• ptr points to a block previously allocated with this allocator.
• old_layout describes exactly the same block.

Errors

Errors are implementation-defined, refer to [Self::Error] and Error.

The standard implementations may return:

• Err(Error::AllocFailed(layout, cause)) if allocation fails. cause is typically Cause::Unknown. If the os_err_reporting feature is enabled, it will be Cause::OSErr. In this case, oserr will be the error from IOErr::last_os_error.raw_os_error().

Implementations on Foreign Types

impl Realloc for Global

Available on non-crate feature no_alloc only.

impl Realloc for System

Available on crate feature std and non-crate feature no_alloc only.

impl<A: Realloc + ?Sized> Realloc for &A

unsafe fn realloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

unsafe fn rezalloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

impl<A: Realloc + ?Sized> Realloc for &mut A

unsafe fn realloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

unsafe fn rezalloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

impl<A: Realloc + ?Sized> Realloc for Box<A>

unsafe fn realloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

unsafe fn rezalloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

impl<A: Realloc + ?Sized> Realloc for Rc<A>

unsafe fn realloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

unsafe fn rezalloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

impl<A: Realloc + ?Sized> Realloc for Arc<A>

unsafe fn realloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

unsafe fn rezalloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

impl<A: ReallocMut + ?Sized> Realloc for RefCell<A>

unsafe fn realloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

unsafe fn rezalloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

impl<A: ReallocMut + ?Sized> Realloc for Mutex<A>

unsafe fn realloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

unsafe fn rezalloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

impl<A: ReallocMut + ?Sized> Realloc for RwLock<A>

unsafe fn realloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

unsafe fn rezalloc( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<u8>, Self::Error>

Implementors

impl Realloc for CAlloc

impl Realloc for DefaultAlloc

Available on non-crate feature no_alloc only.