Struct Hops 

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

Bounded, loop-free list of Hop entries: the hop chain of a broadcast.

Guarantees len() <= MAX_HOPS and that no non-zero Hop appears twice. Both are wire rules, and both hold wherever a list exists rather than only where one was parsed, so a chain that a conforming receiver would reject cannot be built and sent. Construct via Hops::new + Hops::push, or fall back to the fallible TryFrom<Vec<Hop>>.

Implementations

impl Hops

pub fn new() -> Self

Create an empty list.

pub fn push(&mut self, hop: Hop) -> Result<(), InvalidHop>

Append an Hop, rejecting anything a conforming receiver would.

Fails with InvalidHop::TooMany once the list is full, and with InvalidHop::Duplicate for an id already in the chain, which is a loop. The reserved id 0 identifies nothing, so it may repeat.

pub fn contains(&self, hop: &Hop) -> bool

Returns true if any entry matches hop.

pub fn len(&self) -> usize

Number of entries currently in the list (always <= MAX_HOPS).

pub fn is_empty(&self) -> bool

Whether the list contains no entries.

pub fn iter(&self) -> Iter<'_, Hop>

Iterate over the entries in hop order (oldest first).

pub fn as_slice(&self) -> &[Hop]

Borrow the entries as a slice.

Trait Implementations

impl Clone for Hops

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Hops

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

Formats the value using the given formatter.

impl Default for Hops

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Hops

impl<'a> IntoIterator for &'a Hops

type Item = &'a Hop

The type of the elements being iterated over.

type IntoIter = Iter<'a, Hop>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for Hops

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Hops

impl TryFrom<Vec<Hop>> for Hops

type Error = InvalidHop

The type returned in the event of a conversion error.

fn try_from(v: Vec<Hop>) -> Result<Self, Self::Error>

Performs the conversion.