Trait IntoIterGlobalNodes

pub trait IntoIterGlobalNodes: Sized + Copy {
    type Iter: Iterator<Item = Node>;

    // Required methods
    fn iter_nodes(self) -> Self::Iter;
    fn controller_id(self) -> Endpoint;

    // Provided methods
    fn iter_global_nodes(self) -> GlobalNodeIter<Self>  { ... }
    fn extended(self, other: impl IntoIterGlobalNodes) -> Option<NodeCluster> { ... }
    fn to_local_cluster(self) -> NodeCluster { ... }
}

This lets us be agnostic whether a primitive (such as flows_to) is called with a GlobalNode or &NodeCluster.

Note that while GlobalNode implements this trait NodeCluster does not do so directly, but it’s reference &NodeCluster does.

Required Associated Types

type Iter: Iterator<Item = Node>

The iterator returned by Self::iter_nodes

Required Methods

fn iter_nodes(self) -> Self::Iter

iterate over the local nodes

fn controller_id(self) -> Endpoint

The controller id all of these nodes are located in.

Provided Methods

fn iter_global_nodes(self) -> GlobalNodeIter<Self>

Iterate all nodes as globally identified one’s.

The invariant of this iterator is that all controller_id()s of the nodes in the iterator is the same as self.controller_id().

fn extended(self, other: impl IntoIterGlobalNodes) -> Option<NodeCluster>

A convenience method for gathering multiple node(cluster)s together.

Returns None if the controller id’s don’t match or both iterators are empty.

fn to_local_cluster(self) -> NodeCluster

Collect the iterator into a cluster

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl IntoIterGlobalNodes for GlobalNode

type Iter = Once<NodeIndex>

impl<'a> IntoIterGlobalNodes for &'a NodeCluster

type Iter = Iter<'a>