Struct CloserNodes 

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

A bounded list of the K closest NodeIds a responder returns in a closer_nodes field (ADR 022 §Routing Table). Wraps Vec<NodeId> and enforces the MAX_CLOSER_NODES invariant at construction — both CloserNodes::try_new and the bounded Deserialize impl reject oversize lists, so an over-cap closer_nodes cannot exist in memory or on the wire. #[repr(transparent)] + #[serde(transparent)] keep the encoding byte-identical to a bare Vec<NodeId>.

Implementations

impl CloserNodes

pub fn try_new(nodes: Vec<NodeId>) -> Result<Self, CloserNodesError>

Wrap nodes, rejecting lists longer than MAX_CLOSER_NODES.

Errors

Returns CloserNodesError when nodes.len() > MAX_CLOSER_NODES.

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

Borrow the closer nodes as a slice.

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

Iterate over the closer nodes.

pub fn into_inner(self) -> Vec<NodeId>

Consume into the inner Vec<NodeId>.

pub const fn len(&self) -> usize

Number of closer nodes (always <= MAX_CLOSER_NODES).

pub const fn is_empty(&self) -> bool

True if no closer nodes are present.

Trait Implementations

impl Clone for CloserNodes

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 CloserNodes

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

Formats the value using the given formatter.

impl Default for CloserNodes

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CloserNodes

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CloserNodes

impl<'a> IntoIterator for &'a CloserNodes

type Item = &'a NodeId

The type of the elements being iterated over.

type IntoIter = Iter<'a, NodeId>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for CloserNodes

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CloserNodes

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CloserNodes