Primitive Type f16

🔬This is a nightly-only experimental API. (f16 #116909)

A 16-bit floating point type (specifically, the “binary16” type defined in IEEE 754-2008).

This type is very similar to f32 but has decreased precision because it uses half as many bits. Please see [the documentation for f32 or Wikipedia on half-precision values for more information.

See also the std::f16::consts module.

Trait Implementations

impl Add<&f16> for &f16

type Output = <f16 as Add>::Output

The resulting type after applying the + operator.

fn add(self, other: &f16) -> <f16 as Add<f16>>::Output

Performs the + operation.

impl Add<&f16> for f16

type Output = <f16 as Add>::Output

The resulting type after applying the + operator.

fn add(self, other: &f16) -> <f16 as Add<f16>>::Output

Performs the + operation.

impl<'a> Add<f16> for &'a f16

type Output = <f16 as Add>::Output

The resulting type after applying the + operator.

fn add(self, other: f16) -> <f16 as Add<f16>>::Output

Performs the + operation.

impl Add for f16

type Output = f16

The resulting type after applying the + operator.

fn add(self, other: f16) -> f16

Performs the + operation.

impl AddAssign<&f16> for f16

fn add_assign(&mut self, other: &f16)

Performs the += operation.

impl AddAssign for f16

fn add_assign(&mut self, other: f16)

Performs the += operation.

impl Clone for f16

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for f16

fn default() -> f16

Returns the default value of 0.0

impl Div<&f16> for &f16

type Output = <f16 as Div>::Output

The resulting type after applying the / operator.

fn div(self, other: &f16) -> <f16 as Div<f16>>::Output

Performs the / operation.

impl Div<&f16> for f16

type Output = <f16 as Div>::Output

The resulting type after applying the / operator.

fn div(self, other: &f16) -> <f16 as Div<f16>>::Output

Performs the / operation.

impl<'a> Div<f16> for &'a f16

type Output = <f16 as Div>::Output

The resulting type after applying the / operator.

fn div(self, other: f16) -> <f16 as Div<f16>>::Output

Performs the / operation.

impl Div for f16

type Output = f16

The resulting type after applying the / operator.

fn div(self, other: f16) -> f16

Performs the / operation.

impl DivAssign<&f16> for f16

fn div_assign(&mut self, other: &f16)

Performs the /= operation.

impl DivAssign for f16

fn div_assign(&mut self, other: f16)

Performs the /= operation.

impl From<f16> for f128

fn from(small: f16) -> Self

Converts f16 to f128 losslessly.

impl From<f16> for f32

fn from(small: f16) -> Self

Converts f16 to f32 losslessly.

impl From<f16> for f64

fn from(small: f16) -> Self

Converts f16 to f64 losslessly.

impl Mul<&f16> for &f16

type Output = <f16 as Mul>::Output

The resulting type after applying the * operator.

fn mul(self, other: &f16) -> <f16 as Mul<f16>>::Output

Performs the * operation.

impl Mul<&f16> for f16

type Output = <f16 as Mul>::Output

The resulting type after applying the * operator.

fn mul(self, other: &f16) -> <f16 as Mul<f16>>::Output

Performs the * operation.

impl<'a> Mul<f16> for &'a f16

type Output = <f16 as Mul>::Output

The resulting type after applying the * operator.

fn mul(self, other: f16) -> <f16 as Mul<f16>>::Output

Performs the * operation.

impl Mul for f16

type Output = f16

The resulting type after applying the * operator.

fn mul(self, other: f16) -> f16

Performs the * operation.

impl MulAssign<&f16> for f16

fn mul_assign(&mut self, other: &f16)

Performs the *= operation.

impl MulAssign for f16

fn mul_assign(&mut self, other: f16)

Performs the *= operation.

impl Neg for &f16

type Output = <f16 as Neg>::Output

The resulting type after applying the - operator.

fn neg(self) -> <f16 as Neg>::Output

Performs the unary - operation.

impl Neg for f16

type Output = f16

The resulting type after applying the - operator.

fn neg(self) -> f16

Performs the unary - operation.

impl PartialEq for f16

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

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

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

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

impl PartialOrd for f16

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

impl Rem<&f16> for &f16

type Output = <f16 as Rem>::Output

The resulting type after applying the % operator.

fn rem(self, other: &f16) -> <f16 as Rem<f16>>::Output

Performs the % operation.

impl Rem<&f16> for f16

type Output = <f16 as Rem>::Output

The resulting type after applying the % operator.

fn rem(self, other: &f16) -> <f16 as Rem<f16>>::Output

Performs the % operation.

impl<'a> Rem<f16> for &'a f16

type Output = <f16 as Rem>::Output

The resulting type after applying the % operator.

fn rem(self, other: f16) -> <f16 as Rem<f16>>::Output

Performs the % operation.

impl Rem for f16

The remainder from the division of two floats.

The remainder has the same sign as the dividend and is computed as: x - (x / y).trunc() * y.

Examples

let x: f32 = 50.50;
let y: f32 = 8.125;
let remainder = x - (x / y).trunc() * y;

// The answer to both operations is 1.75
assert_eq!(x % y, remainder);

type Output = f16

The resulting type after applying the % operator.

fn rem(self, other: f16) -> f16

Performs the % operation.

impl RemAssign<&f16> for f16

fn rem_assign(&mut self, other: &f16)

Performs the %= operation.

impl RemAssign for f16

fn rem_assign(&mut self, other: f16)

Performs the %= operation.

impl Sub<&f16> for &f16

type Output = <f16 as Sub>::Output

The resulting type after applying the - operator.

fn sub(self, other: &f16) -> <f16 as Sub<f16>>::Output

Performs the - operation.

impl Sub<&f16> for f16

type Output = <f16 as Sub>::Output

The resulting type after applying the - operator.

fn sub(self, other: &f16) -> <f16 as Sub<f16>>::Output

Performs the - operation.

impl<'a> Sub<f16> for &'a f16

type Output = <f16 as Sub>::Output

The resulting type after applying the - operator.

fn sub(self, other: f16) -> <f16 as Sub<f16>>::Output

Performs the - operation.

impl Sub for f16

type Output = f16

The resulting type after applying the - operator.

fn sub(self, other: f16) -> f16

Performs the - operation.

impl SubAssign<&f16> for f16

fn sub_assign(&mut self, other: &f16)

Performs the -= operation.

impl SubAssign for f16

fn sub_assign(&mut self, other: f16)

Performs the -= operation.

impl Copy for f16

impl FloatToInt<i128> for f16

impl FloatToInt<i16> for f16

impl FloatToInt<i32> for f16

impl FloatToInt<i64> for f16

impl FloatToInt<i8> for f16

impl FloatToInt<isize> for f16

impl FloatToInt<u128> for f16

impl FloatToInt<u16> for f16

impl FloatToInt<u32> for f16

impl FloatToInt<u64> for f16

impl FloatToInt<u8> for f16

impl FloatToInt<usize> for f16