Enum kitsune_p2p_dht_arc::DhtArcRange

pub enum DhtArcRange<T = DhtLocation> {
    Empty,
    Full,
    Bounded(T, T),
}

A variant of DHT arc which is intentionally forgetful of the Agent’s location. This type is used in places where set logic (union and intersection) is performed on arcs, which splits and joins arcs in such a way that it doesn’t make sense to claim that the arc belongs to any particular agent or location.

This type exists to make sure we don’t accidentally intepret the starting point of such a “derived” arc as a legitimate agent location.

Variants

Empty

Full

Bounded(T, T)

Implementations

impl<T: PartialOrd + Num> DhtArcRange<T>

pub fn contains<B: Borrow<T>>(&self, t: B) -> bool

impl<T> DhtArcRange<T>

pub fn map<U, F: Fn(T) -> U>(self, f: F) -> DhtArcRange<U>

impl<T: AsPrimitive<u32>> DhtArcRange<T>

pub fn from_bounds(start: T, end: T) -> DhtArcRange<DhtLocation>

pub fn from_start_and_len(start: T, len: u64) -> DhtArcRange<DhtLocation>

pub fn from_start_and_half_len( start: T, half_len: u32 ) -> DhtArcRange<DhtLocation>

Convenience for our legacy code which defined arcs in terms of half-lengths rather than full lengths

pub fn new_generic(start: T, end: T) -> Self

impl DhtArcRange<u32>

pub fn canonical(self) -> DhtArcRange

impl DhtArcRange<DhtLocation>

pub fn new_empty() -> Self

Constructor

pub fn to_bounds_grouped(&self) -> Option<(DhtLocation, DhtLocation)>

Represent an arc as an optional range of inclusive endpoints. If none, the arc length is 0

pub fn to_primitive_bounds_detached(&self) -> (Option<u32>, Option<u32>)

Same as to_bounds_grouped, but with the return type “inside-out”

pub fn is_empty(&self) -> bool

Check if this arc is empty.

pub fn is_full(&self) -> bool

Check if this arc is full.

pub fn is_bounded(&self) -> bool

Check if this arc is bounded.

pub fn dist(&self, tgt: u32) -> u32

Get the min distance to a location. Zero if Full, u32::MAX if Empty.

pub fn overlaps(&self, other: &Self) -> bool

Check if arcs overlap

pub fn overlap_coverage(&self, other: &Self) -> f64

Amount of intersection between two arcs

pub fn coverage(&self) -> f64

The percentage of the full circle that is covered by this arc.

pub fn length(&self) -> u64

pub fn half_length(&self) -> u32

pub fn to_ascii(&self, len: usize) -> String

Handy ascii representation of an arc, especially useful when looking at several arcs at once to get a sense of their overlap

pub fn print(&self, len: usize)

pub fn canonical(self) -> DhtArcRange

Trait Implementations

impl<T: Clone> Clone for DhtArcRange<T>

fn clone(&self) -> DhtArcRange<T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for DhtArcRange<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for DhtArcRange<T>

where T: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&DhtArc> for DhtArcRange

fn from(a: &DhtArc) -> Self

Converts to this type from the input type.

impl From<&DhtArcRange> for DhtArcSet

fn from(arc: &DhtArcRange) -> Self

Converts to this type from the input type.

impl From<DhtArc> for DhtArcRange

fn from(a: DhtArc) -> Self

Converts to this type from the input type.

impl From<DhtArcRange> for DhtArcSet

fn from(arc: DhtArcRange) -> Self

Converts to this type from the input type.

impl<T: Hash> Hash for DhtArcRange<T>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: PartialEq> PartialEq for DhtArcRange<T>

fn eq(&self, other: &DhtArcRange<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> Serialize for DhtArcRange<T>

where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: Copy> Copy for DhtArcRange<T>

impl<T: Eq> Eq for DhtArcRange<T>

impl<T> StructuralPartialEq for DhtArcRange<T>