Struct ResourcePermit 

pub struct ResourcePermit { /* private fields */ }

Represents resource permit.

Implementations

impl ResourcePermit

pub fn try_resize(&mut self, bytes: usize) -> Result<(), BudgetRejection>

Changes the byte reservation without acquiring another count or rate token.

Growth reserves only the difference at each ancestor. A rejection rolls back every added byte and leaves this permit unchanged. Shrinking is allowed after budget closure; callers release the removed payload before shrinking its charge. This method does not block on available capacity.

Errors

Returns a rejection if growth exceeds any ancestor’s byte limit or a dynamic ancestor has closed admission.

pub const fn bytes(&self) -> usize

Returns the bytes.

pub const fn class(&self) -> BudgetClass

Returns the class.

pub fn promote_to_control(&mut self)

Promotes a data reservation to the control class without releasing capacity.

The total count and byte ownership remain unchanged at every budget level. Data-only counters and rate tokens are released before a same-tree rebind can use control reserve.

pub fn try_rebind( &mut self, target: &ResourceBudget, ) -> Result<PermitRebindOutcome, RuntimeContractViolation>

Moves this reservation to another budget in the same resource tree.

Reservations for the common ancestor chain remain owned throughout the transfer. Target-only reservations are acquired before source-only reservations are released, so the payload is always covered without charging common ancestors twice.

Returns a normal rejection when the target is full. Contract failures and rejections leave this permit unchanged and valid for its source.

Errors

Returns crate::RuntimeContractViolation::PermitTargetInDifferentTree when target is outside this permit’s resource-budget tree.

Trait Implementations

impl Debug for ResourcePermit

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

Formats the value using the given formatter.

impl Drop for ResourcePermit

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.