Struct WeightedSet

pub struct WeightedSet<'a> { /* private fields */ }

A structure that represents a set of addresses of the same priority

Implementations

impl<'a> WeightedSet<'a>

pub fn pick_one(&self) -> Option<SocketAddr>

Select one random address to connect to

This function selects a host according to the random distribution according to the weights.

Returns None if the set is empty

pub fn addresses(&self) -> AddressIter<'_>

Returns iterator over underlying addresses

This effectively discards weights, but may be useful for cases where you treat addresses as a set. For example to find out whether two Address values intersect over SocketAddr.

pub fn compare_addresses( &self, other: &WeightedSet<'_>, ) -> (Vec<SocketAddr>, Vec<SocketAddr>)

Compares two weighted sets to find out which addresses have been removed from set or added

This doesn’t compare weights of the addresses

pub fn len(&self) -> usize

Number of addresses contained in set

Trait Implementations

impl<'a> Debug for WeightedSet<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for WeightedSet<'a>

fn eq(&self, other: &WeightedSet<'_>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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