Struct ReservationSet 

pub struct ReservationSet { /* private fields */ }

An atomic, cancellation-safe reservation for several resources.

Implementations

impl ReservationSet

pub fn amounts(&self) -> &BTreeMap<Resource, u64>

Returns the canonical, resource-sorted reservation amounts.

pub fn commit<'a>( self, actual: impl IntoIterator<Item = (&'a Resource, u64)>, ) -> Result<(), BudgetError>

Reconciles actual usage atomically and releases unused capacity.

Duplicate actual entries are combined with checked arithmetic. Omitted resources have zero actual usage. Unknown resources and arithmetic overflow fail closed by converting the full reservation set to consumed capacity before returning an error.

Errors

Returns an error for unknown resources, duplicate-entry overflow, or actual usage beyond a reservation. Accounting is reconciled conservatively before every error is returned.

pub fn commit_all(self)

Converts every reserved amount to consumed capacity.

pub fn release(self)

Explicitly releases the complete reservation set.

Trait Implementations

impl Debug for ReservationSet

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

Formats the value using the given formatter.

impl Drop for ReservationSet

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.