pub struct KBucketRef<'a, TKey, TVal> { /* private fields */ }
Expand description

A reference to a bucket in a KBucketsTable.

Implementations§

source§

impl<'a, TKey, TVal> KBucketRef<'a, TKey, TVal>where TKey: Clone + AsRef<KeyBytes>, TVal: Clone,

source

pub fn range(&self) -> (Distance, Distance)

Returns the minimum inclusive and maximum inclusive Distance for this bucket.

source

pub fn is_empty(&self) -> bool

Checks whether the bucket is empty.

source

pub fn num_entries(&self) -> usize

Returns the number of entries in the bucket.

source

pub fn has_pending(&self) -> bool

Returns true if the bucket has a pending node.

source

pub fn contains(&self, d: &Distance) -> bool

Tests whether the given distance falls into this bucket.

source

pub fn rand_distance(&self, rng: &mut impl Rng) -> Distance

Generates a random distance that falls into this bucket.

Together with a known key a (e.g. the local key), a random distance d for this bucket w.r.t k gives rise to the corresponding (random) key b s.t. the XOR distance between a and b is d. In other words, it gives rise to a random key falling into this bucket. See key::Key::for_distance.

source

pub fn iter(&'a self) -> impl Iterator<Item = EntryRefView<'a, TKey, TVal>>

Returns an iterator over the entries in the bucket.

Auto Trait Implementations§

§

impl<'a, TKey, TVal> RefUnwindSafe for KBucketRef<'a, TKey, TVal>where TKey: RefUnwindSafe, TVal: RefUnwindSafe,

§

impl<'a, TKey, TVal> Send for KBucketRef<'a, TKey, TVal>where TKey: Send, TVal: Send,

§

impl<'a, TKey, TVal> Sync for KBucketRef<'a, TKey, TVal>where TKey: Sync, TVal: Sync,

§

impl<'a, TKey, TVal> Unpin for KBucketRef<'a, TKey, TVal>

§

impl<'a, TKey, TVal> !UnwindSafe for KBucketRef<'a, TKey, TVal>

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere 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.

source§

impl<T, U> Into<U> for Twhere 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> Same<T> for T

§

type Output = T

Should always be Self
source§

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

§

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 Twhere U: TryFrom<T>,

§

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.
source§

impl<V, T> VZip<V> for Twhere V: MultiLane<T>,

source§

fn vzip(self) -> V