Trait Alloc 

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

    // Required method
    fn alloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>;

    // Provided method
    fn zalloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error> { ... }
}

A memory allocation interface.

Required Associated Types

type Error: From<Error> + Debug + Display

The error type returned by this allocator.

Required Methods

fn alloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

Attempts to allocate a block of memory fitting the given Layout.

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

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(oserr). In this case, oserr will be the error from IOErr::last_os_error.raw_os_error().

Provided Methods

fn zalloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

Attempts to allocate a zeroed block of memory fitting the given Layout.

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

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 Alloc for Global

Available on non-crate feature no_alloc only.

type Error = Error

fn alloc(&self, layout: Layout) -> Result<NonNull<u8>, Error>

fn zalloc(&self, layout: Layout) -> Result<NonNull<u8>, Error>

impl Alloc for System

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

type Error = Error

fn alloc(&self, layout: Layout) -> Result<NonNull<u8>, Error>

fn zalloc(&self, layout: Layout) -> Result<NonNull<u8>, Error>

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

type Error = <A as Alloc>::Error

fn alloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

fn zalloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

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

type Error = <A as Alloc>::Error

fn alloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

fn zalloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

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

type Error = <A as Alloc>::Error

fn alloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

fn zalloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

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

type Error = <A as Alloc>::Error

fn alloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

fn zalloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

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

type Error = <A as Alloc>::Error

fn alloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

fn zalloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

impl<A: AllocMut + ?Sized> Alloc for RefCell<A>

type Error = <A as AllocMut>::Error

fn alloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

fn zalloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

impl<A: AllocMut + ?Sized> Alloc for Mutex<A>

type Error = <A as AllocMut>::Error

fn alloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

fn zalloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

impl<A: AllocMut + ?Sized> Alloc for RwLock<A>

type Error = <A as AllocMut>::Error

fn alloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

fn zalloc(&self, layout: Layout) -> Result<NonNull<u8>, Self::Error>

Implementors

impl Alloc for CAlloc

type Error = Error

impl Alloc for DefaultAlloc

Available on non-crate feature no_alloc only.

type Error = Error