Trait IterableByValue

pub trait IterableByValue {
    type Item;
    type Iter<'a>: Iterator<Item = Self::Item>
       where Self: 'a;

    // Required method
    fn iter_value(&self) -> Self::Iter<'_>;
}

A trait for obtaining a value-based iterator.

This trait necessary as all standard Rust containers already have IntoIterator-based methods for obtaining reference-based iterators.

Note that iter_value returns a standard iterator. However, the intended semantics is that the iterator will return values.

If you need to iterate from a given position, and you can implement such an iterator more efficiently, please consider IterableByValueFrom.

Required Associated Types

type Item

type Iter<'a>: Iterator<Item = Self::Item> where Self: 'a

Required Methods

fn iter_value(&self) -> Self::Iter<'_>

Returns an iterator on values.

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.

Implementations on Foreign Types

impl<T: Clone> IterableByValue for [T]

type Item = T

type Iter<'a> = Cloned<Iter<'a, T>> where T: 'a

fn iter_value(&self) -> Self::Iter<'_>

impl<T: Clone> IterableByValue for Box<[T]>

type Item = T

type Iter<'a> = Cloned<Iter<'a, T>> where T: 'a

fn iter_value(&self) -> Self::Iter<'_>

impl<T: Clone> IterableByValue for Vec<T>

type Item = T

type Iter<'a> = Cloned<Iter<'a, T>> where T: 'a

fn iter_value(&self) -> Self::Iter<'_>

impl<T: Clone, const N: usize> IterableByValue for [T; N]

type Item = T

type Iter<'a> = Cloned<Iter<'a, T>> where T: 'a

fn iter_value(&self) -> Self::Iter<'_>

Implementors