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

pub struct DhtArc(_, _);

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<DhtLocation>) -> DhtArc

pub fn empty(loc: DhtLocation) -> DhtArc

pub fn full(loc: DhtLocation) -> DhtArc

pub fn start_loc(&self) -> DhtLocation

pub fn inner(self) -> DhtArcRange<DhtLocation>

pub fn from_parts(a: DhtArcRange<DhtLocation>, 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) -> DhtArcwhere L: Into<DhtLocation>,

pub fn from_start_and_len<L>(start: L, len: u64) -> DhtArcwhere L: Into<DhtLocation>,

pub fn from_bounds<L>(start: L, end: L) -> DhtArcwhere 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<DhtLocation>>

pub fn contains<B>(&self, t: B) -> boolwhere 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 overlaps(&self, other: &DhtArcRange<DhtLocation>) -> bool

Check if arcs overlap

pub fn overlap_coverage(&self, other: &DhtArcRange<DhtLocation>) -> 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) -> Stringwhere 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 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<DhtLocation>

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<DhtLocation>

fn from(a: &DhtArc) -> DhtArcRange<DhtLocation>

Converts to this type from the input type.

impl From<DhtArc> for DhtArcRange<DhtLocation>

fn from(a: DhtArc) -> DhtArcRange<DhtLocation>

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