Struct MemoryReservation 

pub struct MemoryReservation { /* private fields */ }

Exclusive accounting for bytes retained by an operation.

Dropping the value returns its capacity to the context. Reservations cannot be cloned, preventing one charge from representing multiple owners.

Implementations

impl MemoryReservation

pub fn belongs_to(&self, context: &ExecutionContext) -> bool

Reports whether this reservation belongs to the supplied execution account.

pub const fn bytes(&self) -> usize

Returns the charged byte count.

pub fn shrink_to(&mut self, bytes: usize)

Reduces this reservation to the exact retained byte count.

pub fn try_grow(&mut self, additional: usize) -> Result<(), MemoryBudgetError>

Extends this reservation before its owner grows an allocation.

Errors

Returns MemoryBudgetError::Exhausted without changing this reservation when the additional bytes do not fit.

Trait Implementations

impl Debug for MemoryReservation

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

Formats the value using the given formatter.

impl Drop for MemoryReservation

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.