Struct holochain::prelude::kitsune_p2p::dependencies::kitsune_p2p_types::dht_arc::DhtArc

pub struct DhtArc(/* private fields */);

The main DHT arc type. Represents an Agent’s storage Arc on the DHT, preserving the agent’s DhtLocation even in the case of a Full or Empty arc. Contrast to DhtArcRange, which is used for cases where the arc is not associated with any particular Agent, and so the agent’s Location cannot be known.

Implementations

impl DhtArc

pub fn bounded(a: DhtArcRange) -> DhtArc

pub fn empty(loc: DhtLocation) -> DhtArc

pub fn full(loc: DhtLocation) -> DhtArc

pub fn start_loc(&self) -> DhtLocation

pub fn inner(self) -> DhtArcRange

pub fn from_parts(a: DhtArcRange, loc: DhtLocation) -> DhtArc

Construct from an arc range and a location. The location is only used if the arc range is full or empty.

pub fn from_start_and_half_len<L>(start: L, half_len: u32) -> DhtArc

where L: Into<DhtLocation>,

pub fn from_start_and_len<L>(start: L, len: u64) -> DhtArc

where L: Into<DhtLocation>,

pub fn from_bounds<L>(start: L, end: L) -> DhtArc

where L: Into<DhtLocation>,

pub fn update_length(&mut self, new_length: u64)

pub fn range(&self) -> ArcRange

Get the range of the arc

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

Methods from Deref<Target = DhtArcRange>

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

where B: Borrow<T>,

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: &DhtArcRange) -> bool

Check if arcs overlap

pub fn overlap_coverage(&self, other: &DhtArcRange) -> 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 to_ascii_with_ops<L, I>(&self, len: usize, ops: I) -> String

where L: Into<Loc8>, I: IntoIterator<Item = L>,

Ascii representation of an arc, with a histogram of op locations superimposed. Each character of the string, if an op falls in that “bucket”, will be represented by a hexadecimal digit representing the number of ops in that bucket, with a max of 0xF (15)

pub fn print(&self, len: usize)

pub fn as_loc8(&self) -> DhtArcRange<Loc8>

Trait Implementations

impl Clone for DhtArc

fn clone(&self) -> DhtArc

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DhtArc

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

Formats the value using the given formatter.

impl Deref for DhtArc

type Target = DhtArcRange

The resulting type after dereferencing.

fn deref(&self) -> &<DhtArc as Deref>::Target

Dereferences the value.

impl<'de> Deserialize<'de> for DhtArc

fn deserialize<__D>( __deserializer: __D ) -> Result<DhtArc, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&DhtArc> for DhtArcRange

fn from(a: &DhtArc) -> DhtArcRange

Converts to this type from the input type.

impl From<DhtArc> for DhtArcRange

fn from(a: DhtArc) -> DhtArcRange

Converts to this type from the input type.

impl Serialize for DhtArc

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for DhtArc