Struct BufferLease 

pub struct BufferLease { /* private fields */ }

An exclusive writable pool lease. Its initialized length can be shortened after a read, without copying or borrowing the receiver. Drop returns storage to the pool; an I/O backend must retain this owner until its access retires. A lease keeps its backing slab alive even after the pool is dropped.

Implementations

impl BufferLease

pub fn truncate(&mut self, length: usize)

Limit the visible initialized prefix. Panics if the requested length exceeds the current prefix.

pub fn freeze(self) -> FrozenBuffer

Transfer this lease into immutable, independently retainable storage. No allocation or payload copy is required.

Trait Implementations

impl AsMut<[u8]> for BufferLease

fn as_mut(&mut self) -> &mut [u8]

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<[u8]> for BufferLease

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for BufferLease

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

Formats the value using the given formatter.

impl Drop for BufferLease

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl IoBuf for BufferLease

fn slice(self, range: impl RangeBounds<usize>) -> BufferSlice<Self>

where Self: Sized,

Limit an operation to an owned range without copying its bytes. Panics if the range is outside the initialized buffer.

impl IoBufMut for BufferLease

impl ReceiveBuffer for BufferLease

type Frozen = FrozenBuffer

The read-only, cloneable owner produced by freeze.

fn truncate(&mut self, length: usize)

Shorten the initialized prefix after a completed receive. Panics if length exceeds the current prefix. This must not move or replace the backing allocation.

fn freeze(self) -> FrozenBuffer

Consume mutable access and return a read-only owner of the same bytes, without copying them.

impl Send for BufferLease

impl Sync for BufferLease