Struct container_broadcast::broadcast::ReShaped

pub struct ReShaped<T: Broadcastable<M>, const N: usize, const M: usize> { /* fields omitted */ }

Return type of reshaped.

Trait Implementations

impl<T: Broadcastable<M> + BroadcastReceiver<M>, const N: usize, const M: usize> BroadcastReceiver<N> for ReShaped<T, N, M>

type Element = <T as BroadcastReceiver<M>>::Element

fn bget_mut(&mut self, index: [usize; N]) -> Option<&mut Self::Element>

fn receive(
    &mut self,
    broadcast: &impl Broadcastable<DIM, Element = Self::Element>
) -> Option<()>

unsafe fn bc_iter_mut<'a>(&'a mut self) -> BroadcastIterMut<'a, Self, DIM>

To be safe, the BroadcastReceiver must NOT alias bget_mut to the same underlying field for different inputs. You may implement a safe iter_mut method using this on any receiver where that invariant is preserved. If in doubt, use eachindex + bget_mut for a safe solution.

impl<T: Broadcastable<M>, const N: usize, const M: usize> Broadcastable<N> for ReShaped<T, N, M>

type Element = T::Element

fn bget(&self, index: [usize; N]) -> Option<T::Element>

This should return none iff the default inbounds method returns false.

fn mod_bget(&self, index: [isize; DIM]) -> Self::Element

Takes indices modulo size. Useful for periodic shifts of indices.

fn feedto(
    &self,
    receiver: &mut impl BroadcastReceiver<DIM, Element = Self::Element>
) -> Option<()>

Writes the contents of the Broadcastable to a receiver, such as an actual (multidimensional) array.

fn lazy_updim<const NEWDIM: usize>(
    &self,
    size: [usize; NEWDIM]
) -> LazyUpdim<'_, Self, DIM, NEWDIM>

Returns an object with the provided size. If NEWDIM > Self::DIM, the additional indices are ignored. All entries of size input must be either equal to the size of input, except for entries where the original size was 1.

fn reshaped<const NEWDIM: usize>(
    self,
    size: [usize; NEWDIM]
) -> ReShaped<Self, NEWDIM, DIM>

The main way to create multidimensional arrays with this crate, but can resize any broadcastable. Resized broadcastables must have the same number of elements as the old one. Preserves iteration order. Reshapes a broadcastable by linearizing and delinearizing indices.

fn mapindex<F: Fn([usize; M], [usize; M]) -> [usize; DIM], const M: usize>(
    &self,
    indexclosure: F,
    sizeclosure: impl Fn([usize; DIM]) -> [usize; M]
) -> MapIndex<'_, Self, F, DIM, M>

Provides a more flexible but less safe way to reshape a broadcastable. Useful for slicing and dicing arrays and broadcastables, taking diagonals, etc etc.

fn offset_mod(&self, offset: [isize; DIM]) -> OffsetBroadcast<'_, Self, DIM>

Returns a new broadcast which is periodically offset by offset.

fn bmap<T, F: Fn(Self::Element) -> T>(
    &self,
    foo: F
) -> BMap<'_, T, Self, F, DIM>

Elements of returned broadcastable are the output of the provided closure, applied to the input broadcastable.

fn bcloned(self) -> BCloned<Self, DIM>

For inputs whose elements are references, clones them.

fn broadcast2<'a, 'b, T: Broadcastable<N>, const N: usize>(
    &'a self,
    foo: &'b T
) -> Broadcast2<LazyUpdim<'a, Self, DIM, DIM>, LazyUpdim<'b, T, N, DIM>, DIM>

Unique operation not found in Iterators. If the dimensions of the two broadcastable, zips them. If not, will lazy_updim all inputs to the same size. As such, can also provide cartesian or tensor products depending on input. NEW CONSTRAINT IN v0.0.6: N must be smaller than DIM, CHECKED AT RUNTIME. The argument with higher Self::DIM must be first. This is partly to eliminate use of nightly features, and because the Rust type system often cannot prove equality.

fn bc_iter(&self) -> BroadcastIterator<'_, Self, DIM>

Takes a broadcastable and returns an iterator over its elements.

impl<T: Clone + Broadcastable<M>, const N: usize, const M: usize> Clone for ReShaped<T, N, M>

fn clone(&self) -> ReShaped<T, N, M>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Broadcastable<M>, const N: usize, const M: usize> Debug for ReShaped<T, N, M>

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

Formats the value using the given formatter.

impl<T: Eq + Broadcastable<M>, const N: usize, const M: usize> Eq for ReShaped<T, N, M>

impl<'a, T: Broadcastable<M>, const N: usize, const M: usize> IntoIterator for &'a ReShaped<T, N, M>

type Item = T::Element

The type of the elements being iterated over.

type IntoIter = BroadcastIterator<'a, ReShaped<T, N, M>, N>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T: PartialEq + Broadcastable<M>, const N: usize, const M: usize> PartialEq<ReShaped<T, N, M>> for ReShaped<T, N, M>

fn eq(&self, other: &ReShaped<T, N, M>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &ReShaped<T, N, M>) -> bool

This method tests for !=.

impl<T: Broadcastable<M>, const N: usize, const M: usize> StructuralEq for ReShaped<T, N, M>

impl<T: Broadcastable<M>, const N: usize, const M: usize> StructuralPartialEq for ReShaped<T, N, M>

impl<T: Broadcastable<M>, const N: usize, const M: usize> TensorDimension for ReShaped<T, N, M>

const DIM: usize

const ISSCALAR: bool

fn is_scalar(&self) -> bool

impl<T: Broadcastable<M>, const N: usize, const M: usize> TensorSize<N> for ReShaped<T, N, M>

fn size(&self) -> [usize; N]

fn inbounds(&self, index: [usize; DIM]) -> bool

fn eachindex(&self) -> EachIndex<DIM>

Returns an iterator over all valid indices.

const VALIDDIMS: bool

If this is false, you have an invalid implementation.