Struct redox_buffer_pool::ExpandHandle

pub struct ExpandHandle<'a, I: Integer, H: Handle, E: Copy> { /* fields omitted */ }

A handle for expansion. When this handle is retrieved by the BufferPool::begin_expand method, the range has already been reserved, so it's up to this handle to initialize it.

Implementations

impl<'a, I, H, E> ExpandHandle<'a, I, H, E> where
    I: Integer,
    H: Handle,
    E: Copy, 

pub fn len(&self) -> I

Get the length of the range that has been reserved for this specific allocation.

pub fn is_empty(&self) -> bool

Check whether the pending expansion consists of no bytes. Note that zero-sized allocations will panic anyways, so this will always return false, but is still there for completeness.

pub fn offset(&self) -> I

Get the offset within the buffer pool, where this allocation is to take place.

pub unsafe fn initialize(self, pointer: NonNull<u8>, extra: E)

Provide the handle with an actually allocated pointer, initializing the memory range within the buffer pool.

Safety

For this to be safe, the pointer must be a valid allocation (anywhere) of the size originally inputted. The allocation must have the static lifetime, so pointers to the stack obviously don't apply here.