Struct tf32

pub struct tf32(/* private fields */);

A 19-bit floating point type implementing the tfloat32 format.

The tfloat32 floating point format is a truncated 19-bit version of the IEEE 754 standard binary32, a.k.a f32. [bf16] has approximately the same dynamic range as f32 but a a lower precision equal to f16.

Implementations

impl tf32

pub const fn from_bits(bits: u32) -> tf32

Constructs a tf32 value from the raw bits.

pub const fn from_f32(value: f32) -> tf32

Constructs a tf32 value from a 32-bit floating point value.

This operation is lossy. If the 32-bit value is too large to fit, ±∞ will result. NaN values are preserved. Subnormal values that are too tiny to be represented will result in ±0. All other values are truncated and rounded to the nearest representable value.

pub const fn from_f64(value: f64) -> tf32

Constructs a tf32 value from a 64-bit floating point value.

This operation is lossy. If the 64-bit value is to large to fit, ±∞ will result. NaN values are preserved. 64-bit subnormal values are too tiny to be represented and result in ±0. Exponents that underflow the minimum exponent will result in subnormals or ±0. All other values are truncated and rounded to the nearest representable value.

pub const fn to_bits(self) -> u32

Converts a tf32 into the underlying bit representation.

pub const fn to_f32(self) -> f32

Converts a tf32 value into an f32 value.

This conversion is lossless as all values can be represented exactly in f32.

pub const fn to_f64(self) -> f64

Converts a tf32 value into an f64 value.

This conversion is lossless as all values can be represented exactly in f64.

Trait Implementations

impl Add for tf32

type Output = tf32

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl AddAssign for tf32

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl Clone for tf32

fn clone(&self) -> tf32

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for tf32

fn default() -> tf32

Returns the “default value” for a type.

impl Display for tf32

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

Formats the value using the given formatter.

impl Div for tf32

type Output = tf32

The resulting type after applying the / operator.

fn div(self, rhs: Self) -> Self::Output

Performs the / operation.

impl DivAssign for tf32

fn div_assign(&mut self, rhs: Self)

Performs the /= operation.

impl Mul for tf32

type Output = tf32

The resulting type after applying the * operator.

fn mul(self, rhs: Self) -> Self::Output

Performs the * operation.

impl MulAssign for tf32

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl Neg for tf32

type Output = tf32

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl NumCast for tf32

fn from<T: ToPrimitive>(n: T) -> Option<Self>

Creates a number from another value that can be converted into a primitive via the ToPrimitive trait. If the source value cannot be represented by the target type, then None is returned.

impl PartialEq for tf32

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for tf32

fn partial_cmp(&self, other: &tf32) -> 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 Sub for tf32

type Output = tf32

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl SubAssign for tf32

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl ToPrimitive for tf32

fn to_i64(&self) -> Option<i64>

Converts the value of self to an i64. If the value cannot be represented by an i64, then None is returned.

fn to_u64(&self) -> Option<u64>

Converts the value of self to a u64. If the value cannot be represented by a u64, then None is returned.

fn to_f32(&self) -> Option<f32>

Converts the value of self to an f32. Overflows may map to positive or negative inifinity, otherwise None is returned if the value cannot be represented by an f32.

fn to_f64(&self) -> Option<f64>

Converts the value of self to an f64. Overflows may map to positive or negative inifinity, otherwise None is returned if the value cannot be represented by an f64.

fn to_isize(&self) -> Option<isize>

Converts the value of self to an isize. If the value cannot be represented by an isize, then None is returned.

fn to_i8(&self) -> Option<i8>

Converts the value of self to an i8. If the value cannot be represented by an i8, then None is returned.

fn to_i16(&self) -> Option<i16>

Converts the value of self to an i16. If the value cannot be represented by an i16, then None is returned.

fn to_i32(&self) -> Option<i32>

Converts the value of self to an i32. If the value cannot be represented by an i32, then None is returned.

fn to_i128(&self) -> Option<i128>

Converts the value of self to an i128. If the value cannot be represented by an i128 (i64 under the default implementation), then None is returned.

fn to_usize(&self) -> Option<usize>

Converts the value of self to a usize. If the value cannot be represented by a usize, then None is returned.

fn to_u8(&self) -> Option<u8>

Converts the value of self to a u8. If the value cannot be represented by a u8, then None is returned.

fn to_u16(&self) -> Option<u16>

Converts the value of self to a u16. If the value cannot be represented by a u16, then None is returned.

fn to_u32(&self) -> Option<u32>

Converts the value of self to a u32. If the value cannot be represented by a u32, then None is returned.

fn to_u128(&self) -> Option<u128>

Converts the value of self to a u128. If the value cannot be represented by a u128 (u64 under the default implementation), then None is returned.

impl Zeroable for tf32

fn zeroed() -> Self

Calls zeroed.

impl Copy for tf32

impl Pod for tf32

impl StructuralPartialEq for tf32