Skip to main content

Product

Struct Product 

Source
pub struct Product;
Expand description

Multiplicative reduction: computes ∏ data[i].

Identity element is T::ONE. Uses SIMD mul to accumulate lane products, then reduces horizontally via a scalar lane-extraction loop (no prod_reduce on SimdKernel — the hardware does not expose one universally).

§Zero-Cost Guarantee

size_of::<Product>() == 0. All branching over Product vs other ops is eliminated via DCE during monomorphization.

Trait Implementations§

Source§

impl Clone for Product

Source§

fn clone(&self) -> Product

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for Product

Source§

impl Debug for Product

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for Product

Source§

impl PartialEq for Product

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl<T> ReductionOp<T> for Product
where T: NumericElement,

Source§

unsafe fn accumulate<Arch>( acc: <Arch as SimdKernel<T>>::Vector, v: <Arch as SimdKernel<T>>::Vector, ) -> <Arch as SimdKernel<T>>::Vector
where Arch: SimdKernel<T>,

Accumulate: acc = acc * v (lane-wise multiply).

§Safety

Processor must support the target feature of Arch.

Source§

unsafe fn finalize<Arch>(acc: <Arch as SimdKernel<T>>::Vector) -> T
where Arch: SimdKernel<T>,

Finalize: store the accumulated product vector and reduce over lanes.

There is no universal prod_reduce intrinsic, so this falls back to:

  1. Store the LANE_COUNT partial products into a local stack array.
  2. Scalar-fold with *.

For Scalar arch this is always a single-element store + identity.

§Safety

Processor must support the target feature of Arch.

Source§

fn identity_scalar() -> T

The identity element for this reduction as a scalar. Read more
Source§

fn scalar_combine(a: T, b: T) -> T

Combine two scalar partial results using this reduction. Read more
Source§

unsafe fn fma_pair_accumulate<Arch>( acc: <Arch as SimdKernel<T>>::Vector, a: <Arch as SimdKernel<T>>::Vector, b: <Arch as SimdKernel<T>>::Vector, ) -> <Arch as SimdKernel<T>>::Vector
where Arch: SimdKernel<T>,

FMA-aware pairwise accumulation: acc = fuse(acc, a, b) where fuse may use a single fused multiply-add instruction rather than a separate mul + accumulate. Read more
Source§

fn scalar_accumulate(acc: T, elem: T) -> T

Accumulate a single scalar element elem into a scalar accumulator acc. Read more
Source§

unsafe fn identity_vector<Arch>() -> <Arch as SimdKernel<T>>::Vector
where Arch: SimdKernel<T>,

Splat the identity element into a vector register. Read more
Source§

unsafe fn transform_vector<Arch>( v: <Arch as SimdKernel<T>>::Vector, ) -> <Arch as SimdKernel<T>>::Vector
where Arch: SimdKernel<T>,

Per-element lane transform applied before combining (identity by default). Read more
Source§

unsafe fn combine_vectors<Arch>( a: <Arch as SimdKernel<T>>::Vector, b: <Arch as SimdKernel<T>>::Vector, ) -> <Arch as SimdKernel<T>>::Vector
where Arch: SimdKernel<T>,

Merge two partial accumulators WITHOUT the per-element transform. Read more
Source§

impl StructuralPartialEq for Product

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> ArchivePointee for T

Source§

type ArchivedMetadata = ()

The archived version of the pointer metadata for this type.
Source§

fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata, ) -> <T as Pointee>::Metadata

Converts some archived metadata to the pointer metadata for itself.
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CastTo for T
where T: Copy,

Source§

fn cast_to<U>(self) -> U
where U: CastFrom<Self>,

Cast self to type U.
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> LayoutRaw for T

Source§

fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>

Returns the layout of the type.
Source§

impl<T, N1, N2> Niching<NichedOption<T, N1>> for N2
where T: SharedNiching<N1, N2>, N1: Niching<T>, N2: Niching<T>,

Source§

unsafe fn is_niched(niched: *const NichedOption<T, N1>) -> bool

Returns whether the given value has been niched. Read more
Source§

fn resolve_niched(out: Place<NichedOption<T, N1>>)

Writes data to out indicating that a T is niched.
Source§

impl<T> Pointee for T

Source§

type Metadata = ()

The metadata type for pointers and references to this type.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.