Trait NdProducer

pub trait NdProducer {
    type Item;
    type Dim: Dimension;

    // Required methods
    fn raw_dim(&self) -> Self::Dim;
    fn __private__(&self) -> PrivateMarker;
}

A producer of an n-dimensional set of elements; for example an array view, mutable array view or an iterator that yields chunks.

Producers are used as a arguments to Zip and azip!().

Comparison to IntoIterator

Most NdProducers are iterable (implement IntoIterator) but not directly iterators. This separation is needed because the producer represents a multidimensional set of items, it can be split along a particular axis for parallelization, and it has no fixed correspondance to a sequence.

The natural exception is one dimensional producers, like AxisIter, which implement Iterator directly (AxisIter traverses a one dimensional sequence, along an axis, while producing multidimensional items).

See also IntoNdProducer

Required Associated Types

type Item

The element produced per iteration.

type Dim: Dimension

Dimension type

Required Methods

fn raw_dim(&self) -> Self::Dim

Return the shape of the producer.

fn __private__(&self) -> PrivateMarker

This trait is private to implement; this method exists to make it impossible to implement outside the crate.

Implementors

impl<'a, A, D: Dimension> NdProducer for AxisIter<'a, A, D>

type Item = <AxisIter<'a, A, D> as Iterator>::Item

type Dim = Dim<[usize; 1]>

impl<'a, A, D: Dimension> NdProducer for AxisIterMut<'a, A, D>

type Item = <AxisIterMut<'a, A, D> as Iterator>::Item

type Dim = Dim<[usize; 1]>

impl<'a, A, D: Dimension> NdProducer for ExactChunks<'a, A, D>

type Item = ArrayBase<ViewRepr<&'a A>, D>

type Dim = D

impl<'a, A, D: Dimension> NdProducer for ExactChunksMut<'a, A, D>

type Item = ArrayBase<ViewRepr<&'a mut A>, D>

type Dim = D

impl<'a, A, D: Dimension> NdProducer for Lanes<'a, A, D>

type Item = ArrayBase<ViewRepr<&'a A>, Dim<[usize; 1]>>

type Dim = D

impl<'a, A, D: Dimension> NdProducer for LanesMut<'a, A, D>

type Item = ArrayBase<ViewRepr<&'a mut A>, Dim<[usize; 1]>>

type Dim = D

impl<'a, A, D: Dimension> NdProducer for Windows<'a, A, D>

type Item = ArrayBase<ViewRepr<&'a A>, D>

type Dim = D

impl<'a, A, D: Dimension> NdProducer for ArrayView<'a, A, D>

type Item = &'a A

type Dim = D

impl<'a, A, D: Dimension> NdProducer for ArrayViewMut<'a, A, D>

type Item = &'a mut A

type Dim = D

impl<A, D: Dimension> NdProducer for RawArrayView<A, D>

type Item = *const A

type Dim = D

impl<A, D: Dimension> NdProducer for RawArrayViewMut<A, D>

type Item = *mut A

type Dim = D

impl<D: Dimension + Copy> NdProducer for Indices<D>

type Item = <D as Dimension>::Pattern

type Dim = D