Struct F4 

#[repr(transparent)]
pub struct F4(pub u8);

Finite-only 4-bit float: E3M0 with the top exponent reserved for NaN.

Tuple Fields

0: u8

Implementations

impl F4

pub fn to_f32(self) -> f32

Convert to f32 exactly.

pub fn from_f32(val: f32) -> F4

Convert from f32 with round-to-nearest, ties-to-even.

Infinity and finite overflow saturate to the signed maximum finite value. NaN maps to the reserved top exponent.

pub fn pack_pair(low: F4, high: F4) -> u8

Pack two F4 values into one byte.

pub fn unpack_pair(packed: u8) -> (F4, F4)

Unpack one byte into two F4 values.

Trait Implementations

impl Add for F4

type Output = F4

The resulting type after applying the + operator.

fn add(self, rhs: F4) -> F4

Performs the + operation.

impl AddAssign for F4

fn add_assign(&mut self, rhs: F4)

Performs the += operation.

impl CastFrom<Bf4> for F4

fn cast_from(val: Bf4) -> F4

Cast from type T to Self.

impl CastFrom<Bf8> for F4

fn cast_from(val: Bf8) -> F4

Cast from type T to Self.

impl CastFrom<Bf16> for F4

fn cast_from(val: Bf16) -> F4

Cast from type T to Self.

impl CastFrom<F4> for f32

fn cast_from(val: F4) -> f32

Cast from type T to Self.

impl CastFrom<F4> for f64

fn cast_from(val: F4) -> f64

Cast from type T to Self.

impl CastFrom<F4> for i8

fn cast_from(val: F4) -> i8

Cast from type T to Self.

impl CastFrom<F4> for i16

fn cast_from(val: F4) -> i16

Cast from type T to Self.

impl CastFrom<F4> for i32

fn cast_from(val: F4) -> i32

Cast from type T to Self.

impl CastFrom<F4> for usize

fn cast_from(val: F4) -> usize

Cast from type T to Self.

impl CastFrom<F4> for I8

fn cast_from(val: F4) -> I8

Cast from type T to Self.

impl CastFrom<F4> for I16

fn cast_from(val: F4) -> I16

Cast from type T to Self.

impl CastFrom<F4> for I32

fn cast_from(val: F4) -> I32

Cast from type T to Self.

impl CastFrom<F4> for F16

fn cast_from(val: F4) -> F16

Cast from type T to Self.

impl CastFrom<F4> for F32

fn cast_from(val: F4) -> F32

Cast from type T to Self.

impl CastFrom<F4> for F64

fn cast_from(val: F4) -> F64

Cast from type T to Self.

impl CastFrom<F4> for Bf16

fn cast_from(val: F4) -> Bf16

Cast from type T to Self.

impl CastFrom<F4> for Bf8

fn cast_from(val: F4) -> Bf8

Cast from type T to Self.

impl CastFrom<F4> for Bf4

fn cast_from(val: F4) -> Bf4

Cast from type T to Self.

impl CastFrom<F4> for F8

fn cast_from(val: F4) -> F8

Cast from type T to Self.

impl CastFrom<F4> for F4

fn cast_from(val: F4) -> F4

Cast from type T to Self.

impl CastFrom<F8> for F4

fn cast_from(val: F8) -> F4

Cast from type T to Self.

impl CastFrom<F16> for F4

fn cast_from(val: F16) -> F4

Cast from type T to Self.

impl CastFrom<F32> for F4

fn cast_from(val: F32) -> F4

Cast from type T to Self.

impl CastFrom<F64> for F4

fn cast_from(val: F64) -> F4

Cast from type T to Self.

impl CastFrom<I8> for F4

fn cast_from(val: I8) -> F4

Cast from type T to Self.

impl CastFrom<I16> for F4

fn cast_from(val: I16) -> F4

Cast from type T to Self.

impl CastFrom<I32> for F4

fn cast_from(val: I32) -> F4

Cast from type T to Self.

impl CastFrom<f32> for F4

fn cast_from(val: f32) -> F4

Cast from type T to Self.

impl CastFrom<f64> for F4

fn cast_from(val: f64) -> F4

Cast from type T to Self.

impl CastFrom<i8> for F4

fn cast_from(val: i8) -> F4

Cast from type T to Self.

impl CastFrom<i16> for F4

fn cast_from(val: i16) -> F4

Cast from type T to Self.

impl CastFrom<i32> for F4

fn cast_from(val: i32) -> F4

Cast from type T to Self.

impl Clone for F4

fn clone(&self) -> F4

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for F4

impl Debug for F4

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

Formats the value using the given formatter.

impl Default for F4

fn default() -> F4

Returns the “default value” for a type.

impl Div for F4

type Output = F4

The resulting type after applying the / operator.

fn div(self, rhs: F4) -> F4

Performs the / operation.

impl FloatElement for F4

fn from_f32(val: f32) -> F4

Convert from f32.

fn from_f64(val: f64) -> F4

Convert from f64.

fn to_f32(self) -> f32

Cast to f32.

fn exp(self) -> Self

e^self.

fn ln(self) -> Self

Natural logarithm.

fn sin(self) -> Self

Sine (radians).

fn cos(self) -> Self

Cosine (radians).

fn acos(self) -> Self

Inverse cosine (radians).

fn tan(self) -> Self

Tangent (radians).

fn sinh(self) -> Self

Hyperbolic sine.

fn cosh(self) -> Self

Hyperbolic cosine.

fn tanh(self) -> Self

Hyperbolic tangent.

fn atan2(self, other: Self) -> Self

Four-quadrant arctangent of self / other.

fn powf(self, n: Self) -> Self

self raised to the power n.

fn recip(self) -> Self

Reciprocal 1 / self.

fn floor(self) -> Self

Largest integer ≤ self.

fn ceil(self) -> Self

Smallest integer ≥ self.

fn round(self) -> Self

Nearest integer, half away from zero.

fn trunc(self) -> Self

Integer part (toward zero).

fn signum(self) -> Self

Sign of self: 1 for positive/+0, -1 for negative/-0, NaN for NaN (matching f64::signum / num_traits::Float::signum).

fn powi(self, n: i32) -> Self

self raised to an integer power via exponentiation by squaring.

fn log10(self) -> Self

Base-10 logarithm, log₁₀(self).

fn log2(self) -> Self

Base-2 logarithm, log₂(self).

fn erf(self) -> Self

Error function erf(self) = 2/√π ∫₀ˢᵉˡᶠ e^(-t²) dt.

fn erfc(self) -> Self

Complementary error function erfc(self) = 1 - erf(self), computed without the cancellation error of 1 - erf for large self.

fn lgamma(self) -> Self

Natural logarithm of the absolute value of the gamma function, ln|Γ(self)|.

fn default_epsilon() -> Self

where Self: RealField,

Machine epsilon (nalgebra::RealField::default_epsilon compatibility alias).

fn pi() -> Self

where Self: RealField,

Returns π as this float type (nalgebra compatibility alias for RealField::PI).

fn max(self, other: Self) -> Self

Componentwise maximum (method form; prefer NumericElement::max_scalar in new code).

fn min(self, other: Self) -> Self

Componentwise minimum (method form; prefer NumericElement::min_scalar in new code).

fn norm(self) -> Self

L2 (Euclidean) norm — for scalars this is the absolute value.

impl Mul for F4

type Output = F4

The resulting type after applying the * operator.

fn mul(self, rhs: F4) -> F4

Performs the * operation.

impl MulAssign for F4

fn mul_assign(&mut self, rhs: F4)

Performs the *= operation.

impl Neg for F4

type Output = F4

The resulting type after applying the - operator.

fn neg(self) -> F4

Performs the unary - operation.

impl NumericElement for F4

const ZERO: F4

Additive identity.

const ONE: F4

Multiplicative identity.

const NAN: F4

IEEE 754 not-a-number sentinel.

const INFINITY: F4

IEEE 754 positive infinity.

const MIN_VALUE: F4

The minimum representable finite value (negative infinity or i32::MIN).

const MAX_VALUE: F4

The maximum representable finite value (positive infinity or i32::MAX).

const BYTE_WIDTH: usize = 1

Number of bytes per element.

const ALL_ONES: F4

Bitwise representation with all bits set to 1.

const SIGN_MASK: F4

IEEE 754 sign-bit mask: only the most-significant bit is set.

fn abs(self) -> F4

Absolute value.

fn scalar_fmadd(self, b: F4, c: F4) -> F4

Scalar fused multiply-add: (self * b) + c.

fn sqrt(self) -> F4

Square root. Floats follow IEEE 754 (NaN for negative inputs); integers return the exact floor integer square root (isqrt), with negative signed inputs defined to return 0 (integers have no NaN to signal the domain error). No f64 round-trip, so the integer result is exact for all operands.

fn is_finite(self) -> bool

Returns true if finite.

fn is_nan(self) -> bool

Returns true if NaN.

fn to_f64(self) -> f64

Cast to f64.

fn bitand(self, rhs: F4) -> F4

Bitwise AND.

fn bitor(self, rhs: F4) -> F4

Bitwise OR.

fn bitxor(self, rhs: F4) -> F4

Bitwise XOR.

fn count_ones(self) -> u32

Count set bits (population count).

fn min_scalar(self, other: Self) -> Self

where Self: PartialOrd,

Elementwise minimum: returns self if self <= other, else other.

fn max_scalar(self, other: Self) -> Self

where Self: PartialOrd,

Elementwise maximum: returns self if self >= other, else other.

fn saturating_add(self, rhs: Self) -> Self

Saturating addition.

fn saturating_mul(self, rhs: Self) -> Self

Saturating multiplication.

fn checked_add(self, rhs: Self) -> Option<Self>

Checked addition: returns Some(self + rhs) or None on integer overflow.

fn checked_mul(self, rhs: Self) -> Option<Self>

Checked multiplication: returns Some(self * rhs) or None on integer overflow.

impl Packable4 for F4

type Unpacked = F32

The unpacked representation type.

fn pack_pair(low: F4, high: F4) -> u8

Pack a low and high element into a single byte.

fn unpack_pair(packed: u8) -> (F4, F4)

Unpack a single byte into a low and high element.

fn unpack_slice_packed(packed: &[u8], unpacked: &mut [F32])

Unpack a slice of packed pairs to a slice of unpacked elements.

fn unpack_single(element: F4) -> F32

Unpack a single element.

impl PartialEq for F4

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for F4

fn partial_cmp(&self, other: &F4) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Pod for F4

impl Pod for F4

impl Rem for F4

type Output = F4

The resulting type after applying the % operator.

fn rem(self, rhs: F4) -> F4

Performs the % operation.

impl RemAssign for F4

fn rem_assign(&mut self, rhs: F4)

Performs the %= operation.

impl StructuralPartialEq for F4

impl Sub for F4

type Output = F4

The resulting type after applying the - operator.

fn sub(self, rhs: F4) -> F4

Performs the - operation.

impl SubAssign for F4

fn sub_assign(&mut self, rhs: F4)

Performs the -= operation.

impl UnitScalar for F4

fn scale_by_f64(self, factor: f64) -> F4

Scale this value by a real coefficient in the scalar’s native precision.

impl Zeroable for F4

fn zeroed() -> Self

Returns a value of Self with every byte set to zero.

impl Zeroable for F4

fn zeroed() -> Self

Calls zeroed.