Struct Clamp 

pub struct Clamp<T>
where
    T: Copy,
{
    pub lo: T,
    pub hi: T,
}

Elementwise clamp: min(max(a[i], lo), hi).

Unlike the other strategies, Clamp carries its bounds as value fields — the bounds are T-typed and cannot be encoded as const generics for a generic T. The struct is Copy and 2×size_of::<T>() bytes; the compiler monomorphizes per (T, Arch) pair.

Usage

Elementwise clamp: a[i].clamp(lo, hi).

For binary elementwise use via zip_cow, the second operand is ignored — bounds are carried in the struct and broadcast-splat at each SIMD iteration. For unary use via map_unary, pass Clamp { lo, hi } directly.

Inlined by the optimizer at each monomorphization site: Clamp<T> bounds become register-constant splat values with no indirect reads.

Fields

lo: T

Lower bound (inclusive).

hi: T

Upper bound (inclusive).

Implementations

impl<T> Clamp<T>

where T: Copy,

pub fn new(lo: T, hi: T) -> Clamp<T>

Construct a new Clamp strategy with the given bounds.

Trait Implementations

impl<T> Clone for Clamp<T>

where T: Clone + Copy,

fn clone(&self) -> Clamp<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Copy for Clamp<T>

where T: Copy,

impl<T> Debug for Clamp<T>

where T: Debug + Copy,

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

Formats the value using the given formatter.

impl<T> ElementOp<T> for Clamp<T>

where T: NumericElement + Copy,

unsafe fn apply<Arch>( self, a: <Arch as SimdKernel<T>>::Vector, _b: <Arch as SimdKernel<T>>::Vector, ) -> <Arch as SimdKernel<T>>::Vector

where Arch: SimdKernel<T>,

Clamp lanes: min(max(a_lane, lo_splat), hi_splat).

The second operand _b is unused — Clamp is a unary operation whose bounds are carried in the struct. Use clamp_cow or transform_with_clamp to apply this as a true single-operand transform.

The compiler hoists the splat(lo) and splat(hi) outside the vectorized loop because self is captured by value in each zip_cow iteration.

fn apply_scalar(self, a: T, _b: T) -> T

Apply the operation to two individual scalar elements.

impl<T> PartialEq for Clamp<T>

where T: PartialEq + Copy,

fn eq(&self, other: &Clamp<T>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<T> StructuralPartialEq for Clamp<T>

where T: PartialEq + Copy,

impl<T> UnaryOp<T> for Clamp<T>

where T: NumericElement + PartialOrd,

unsafe fn apply<Arch>( self, v: <Arch as SimdKernel<T>>::Vector, ) -> <Arch as SimdKernel<T>>::Vector

where Arch: SimdKernel<T>,

Apply the operation to a vector: self.apply::<Arch>(v) -> result.

fn apply_scalar(self, a: T) -> T

Apply the operation to a single scalar element.