Trait AllocTemp 

pub trait AllocTemp {
    type Error: From<Error> + Debug + Display;

    // Required method
    unsafe fn alloc_temp<R, F: FnOnce(NonNull<u8>) -> R>(
        &self,
        layout: Layout,
        with_mem: F,
    ) -> Result<R, Self::Error>;

    // Provided method
    unsafe fn zalloc_temp<R, F: FnOnce(NonNull<u8>) -> R>(
        &self,
        layout: Layout,
        with_mem: F,
    ) -> Result<R, Self::Error> { ... }
}

A memory allocation interface which may only be able to provide temporary, scoped allocations.

Required Associated Types

type Error: From<Error> + Debug + Display

The error type returned by this allocator.

Required Methods

unsafe fn alloc_temp<R, F: FnOnce(NonNull<u8>) -> R>( &self, layout: Layout, with_mem: F, ) -> Result<R, Self::Error>

Attempts to allocate a block of memory fitting the given Layout, and calls with_mem on the returned pointer on success.

Errors

Errors are implementation-defined, refer to AllocTemp::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(oserr). In this case, oserr will be the error from last_os_error().raw_os_error().
• Err(Error::ZeroSizedLayout) if layout.size() == 0.
• Err(Error::CaughtUnwind) if the catch_unwind feature is enabled and an unwind occurs in a function which is not allowed to unwind.

Safety

Safety preconditions are implementation defined.

Provided Methods

unsafe fn zalloc_temp<R, F: FnOnce(NonNull<u8>) -> R>( &self, layout: Layout, with_mem: F, ) -> Result<R, Self::Error>

Attempts to allocate a block of zeroed memory fitting the given Layout, and calls with_mem on the returned pointer on success.

Errors

Errors are implementation-defined, refer to AllocTemp::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(oserr). In this case, oserr will be the error from last_os_error().raw_os_error().
• Err(Error::ZeroSizedLayout) if layout.size() == 0.
• Err(Error::CaughtUnwind) if the catch_unwind feature is enabled and an unwind occurs in a function which is not allowed to unwind.

Safety

Safety preconditions are implementation defined.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl AllocTemp for StackAlloc

type Error = Error

impl<A: BasicAlloc> AllocTemp for A

type Error = <A as Alloc>::Error