Struct frame_support::weights::WeightMeter
source · pub struct WeightMeter {
pub consumed: Weight,
pub limit: Weight,
}
Expand description
Meters consumed weight and a hard limit for the maximal consumable weight.
Can be used to check if enough weight for an operation is available before committing to it.
Example
use sp_weights::{Weight, WeightMeter};
// The weight is limited to (10, 0).
let mut meter = WeightMeter::from_limit(Weight::from_parts(10, 0));
// There is enough weight remaining for an operation with (5, 0) weight.
assert!(meter.check_accrue(Weight::from_parts(5, 0)));
// There is not enough weight remaining for an operation with (6, 0) weight.
assert!(!meter.check_accrue(Weight::from_parts(6, 0)));
Fields§
§consumed: Weight
The already consumed weight.
limit: Weight
The maximal consumable weight.
Implementations§
source§impl WeightMeter
impl WeightMeter
sourcepub fn from_limit(limit: Weight) -> WeightMeter
pub fn from_limit(limit: Weight) -> WeightMeter
Creates Self
from a limit for the maximal consumable weight.
sourcepub fn max_limit() -> WeightMeter
pub fn max_limit() -> WeightMeter
Creates Self
with the maximal possible limit for the consumable weight.
sourcepub fn consumed_ratio(&self) -> Perbill
pub fn consumed_ratio(&self) -> Perbill
The ratio of consumed weight to the limit.
Calculates one ratio per component and returns the largest.
sourcepub fn defensive_saturating_accrue(&mut self, w: Weight)
pub fn defensive_saturating_accrue(&mut self, w: Weight)
Consume some weight and defensively fail if it is over the limit. Saturate in any case.
sourcepub fn check_accrue(&mut self, w: Weight) -> bool
pub fn check_accrue(&mut self, w: Weight) -> bool
Consume the given weight after checking that it can be consumed. Otherwise do nothing.
sourcepub fn can_accrue(&self, w: Weight) -> bool
pub fn can_accrue(&self, w: Weight) -> bool
Check if the given weight can be consumed.
Trait Implementations§
source§impl Clone for WeightMeter
impl Clone for WeightMeter
source§fn clone(&self) -> WeightMeter
fn clone(&self) -> WeightMeter
Returns a copy of the value. Read more
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source
. Read moreAuto Trait Implementations§
impl RefUnwindSafe for WeightMeter
impl Send for WeightMeter
impl Sync for WeightMeter
impl Unpin for WeightMeter
impl UnwindSafe for WeightMeter
Blanket Implementations§
source§impl<T> CheckedConversion for T
impl<T> CheckedConversion for T
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T, Outer> IsWrappedBy<Outer> for Twhere
Outer: AsRef<T> + AsMut<T> + From<T>,
T: From<Outer>,
impl<T, Outer> IsWrappedBy<Outer> for Twhere Outer: AsRef<T> + AsMut<T> + From<T>, T: From<Outer>,
§impl<T> Pointable for T
impl<T> Pointable for T
source§impl<T> SaturatedConversion for T
impl<T> SaturatedConversion for T
source§fn saturated_from<T>(t: T) -> Selfwhere
Self: UniqueSaturatedFrom<T>,
fn saturated_from<T>(t: T) -> Selfwhere Self: UniqueSaturatedFrom<T>,
source§fn saturated_into<T>(self) -> Twhere
Self: UniqueSaturatedInto<T>,
fn saturated_into<T>(self) -> Twhere Self: UniqueSaturatedInto<T>,
Consume self to return an equivalent value of
T
. Read moresource§impl<S, T> UncheckedInto<T> for Swhere
T: UncheckedFrom<S>,
impl<S, T> UncheckedInto<T> for Swhere T: UncheckedFrom<S>,
source§fn unchecked_into(self) -> T
fn unchecked_into(self) -> T
The counterpart to
unchecked_from
.source§impl<T, S> UniqueSaturatedInto<T> for Swhere
T: Bounded,
S: TryInto<T>,
impl<T, S> UniqueSaturatedInto<T> for Swhere T: Bounded, S: TryInto<T>,
source§fn unique_saturated_into(self) -> T
fn unique_saturated_into(self) -> T
Consume self to return an equivalent value of
T
.