ShardedCountAndSize

Struct ShardedCountAndSize 

Source
pub struct ShardedCountAndSize { /* private fields */ }
Expand description

Reduces contention when counting live items and their total size across threads.

Updates are keyed by item identity, allowing different threads to add and remove an item without accumulating per-thread imbalances. Construction and updates never allocate memory.

Implementations§

Source§

impl ShardedCountAndSize

Source

pub const fn new() -> Self

Creates an empty counter, suitable for static initialization.

Source

pub fn add(&self, key: usize, size: usize)

Adds an item. Use the same key and size when removing it.

The live item count and combined size must not exceed usize::MAX. Updates wrap on overflow.

Source

pub fn sub(&self, key: usize, size: usize)

Removes a previously added item, using its original key and size.

Source

pub fn load(&self) -> CountAndSize

Returns sampled totals, exact when updates are idle.

Concurrent updates may make the count and size each overestimate or underestimate the true value independently. Totals saturate at usize::MAX instead of overflowing.

Source

pub fn load_size(&self) -> usize

Returns the sampled total size, with the same semantics as Self::load.

Trait Implementations§

Source§

impl Default for ShardedCountAndSize

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more