#[repr(C, align(8))]pub struct Float64(pub f64);Expand description
A wire-encoded f64
Tuple Fields§
§0: f64Methods from Deref<Target = f64>§
pub const RADIX: u32 = 2
pub const BITS: u32 = 64
pub const MANTISSA_DIGITS: u32 = 53
pub const DIGITS: u32 = 15
pub const EPSILON: f64 = 2.2204460492503131e-16_f64
pub const MIN: f64 = -1.7976931348623157e+308_f64
pub const MIN_POSITIVE: f64 = 2.2250738585072014e-308_f64
pub const MAX: f64 = 1.7976931348623157e+308_f64
pub const MIN_EXP: i32 = -1021
pub const MAX_EXP: i32 = 1024
pub const MIN_10_EXP: i32 = -307
pub const MAX_10_EXP: i32 = 308
pub const NAN: f64
pub const INFINITY: f64
pub const NEG_INFINITY: f64
1.62.0 · Sourcepub fn total_cmp(&self, other: &f64) -> Ordering
pub fn total_cmp(&self, other: &f64) -> Ordering
Returns the ordering between self and other.
Unlike the standard partial comparison between floating point numbers,
this comparison always produces an ordering in accordance to
the totalOrder predicate as defined in the IEEE 754 (2008 revision)
floating point standard. The values are ordered in the following sequence:
- negative quiet NaN
- negative signaling NaN
- negative infinity
- negative numbers
- negative subnormal numbers
- negative zero
- positive zero
- positive subnormal numbers
- positive numbers
- positive infinity
- positive signaling NaN
- positive quiet NaN.
The ordering established by this function does not always agree with the
PartialOrd and PartialEq implementations of f64. For example,
they consider negative and positive zero equal, while total_cmp
doesn’t.
The interpretation of the signaling NaN bit follows the definition in the IEEE 754 standard, which may not match the interpretation by some of the older, non-conformant (e.g. MIPS) hardware implementations.
§Example
struct GoodBoy {
name: String,
weight: f64,
}
let mut bois = vec![
GoodBoy { name: "Pucci".to_owned(), weight: 0.1 },
GoodBoy { name: "Woofer".to_owned(), weight: 99.0 },
GoodBoy { name: "Yapper".to_owned(), weight: 10.0 },
GoodBoy { name: "Chonk".to_owned(), weight: f64::INFINITY },
GoodBoy { name: "Abs. Unit".to_owned(), weight: f64::NAN },
GoodBoy { name: "Floaty".to_owned(), weight: -5.0 },
];
bois.sort_by(|a, b| a.weight.total_cmp(&b.weight));
// `f64::NAN` could be positive or negative, which will affect the sort order.
if f64::NAN.is_sign_negative() {
assert!(bois.into_iter().map(|b| b.weight)
.zip([f64::NAN, -5.0, 0.1, 10.0, 99.0, f64::INFINITY].iter())
.all(|(a, b)| a.to_bits() == b.to_bits()))
} else {
assert!(bois.into_iter().map(|b| b.weight)
.zip([-5.0, 0.1, 10.0, 99.0, f64::INFINITY, f64::NAN].iter())
.all(|(a, b)| a.to_bits() == b.to_bits()))
}Trait Implementations§
Source§impl AddAssign<&Float64> for Float64
impl AddAssign<&Float64> for Float64
Source§fn add_assign(&mut self, other: &Float64)
fn add_assign(&mut self, other: &Float64)
Performs the
+= operation. Read moreSource§impl AddAssign<&f64> for Float64
impl AddAssign<&f64> for Float64
Source§fn add_assign(&mut self, other: &f64)
fn add_assign(&mut self, other: &f64)
Performs the
+= operation. Read moreSource§impl AddAssign<f64> for Float64
impl AddAssign<f64> for Float64
Source§fn add_assign(&mut self, other: f64)
fn add_assign(&mut self, other: f64)
Performs the
+= operation. Read moreSource§impl AddAssign for Float64
impl AddAssign for Float64
Source§fn add_assign(&mut self, other: Float64)
fn add_assign(&mut self, other: Float64)
Performs the
+= operation. Read moreSource§impl Constrained for Float64
impl Constrained for Float64
Source§type Constraint = ()
type Constraint = ()
Type of constraint information for this type.
Source§fn validate(
_: Slot<'_, Self>,
_: Self::Constraint,
) -> Result<(), ValidationError>
fn validate( _: Slot<'_, Self>, _: Self::Constraint, ) -> Result<(), ValidationError>
Validate a slot of this type against a constraint. Can be called when
pointers/envelopes are just presence markers.
Source§impl DivAssign<&Float64> for Float64
impl DivAssign<&Float64> for Float64
Source§fn div_assign(&mut self, other: &Float64)
fn div_assign(&mut self, other: &Float64)
Performs the
/= operation. Read moreSource§impl DivAssign<&f64> for Float64
impl DivAssign<&f64> for Float64
Source§fn div_assign(&mut self, other: &f64)
fn div_assign(&mut self, other: &f64)
Performs the
/= operation. Read moreSource§impl DivAssign<f64> for Float64
impl DivAssign<f64> for Float64
Source§fn div_assign(&mut self, other: f64)
fn div_assign(&mut self, other: f64)
Performs the
/= operation. Read moreSource§impl DivAssign for Float64
impl DivAssign for Float64
Source§fn div_assign(&mut self, other: Float64)
fn div_assign(&mut self, other: Float64)
Performs the
/= operation. Read moreSource§impl<E: ?Sized> Encode<Float64, E> for &Float64
impl<E: ?Sized> Encode<Float64, E> for &Float64
Source§fn encode(
self,
_: &mut E,
out: &mut MaybeUninit<Float64>,
_: <Float64 as Constrained>::Constraint,
) -> Result<(), EncodeError>
fn encode( self, _: &mut E, out: &mut MaybeUninit<Float64>, _: <Float64 as Constrained>::Constraint, ) -> Result<(), EncodeError>
Encodes this value into an encoder and output.
Source§const COPY_OPTIMIZATION: CopyOptimization<Self, W> = _
const COPY_OPTIMIZATION: CopyOptimization<Self, W> = _
Source§impl<E: ?Sized> Encode<Float64, E> for &f64
impl<E: ?Sized> Encode<Float64, E> for &f64
Source§fn encode(
self,
_: &mut E,
out: &mut MaybeUninit<Float64>,
_: <Float64 as Constrained>::Constraint,
) -> Result<(), EncodeError>
fn encode( self, _: &mut E, out: &mut MaybeUninit<Float64>, _: <Float64 as Constrained>::Constraint, ) -> Result<(), EncodeError>
Encodes this value into an encoder and output.
Source§const COPY_OPTIMIZATION: CopyOptimization<Self, W> = _
const COPY_OPTIMIZATION: CopyOptimization<Self, W> = _
Source§impl<E: ?Sized> Encode<Float64, E> for Float64
impl<E: ?Sized> Encode<Float64, E> for Float64
Source§const COPY_OPTIMIZATION: CopyOptimization<Float64, Float64> = crate::CopyOptimization<Float64, Float64>::PRIMITIVE
const COPY_OPTIMIZATION: CopyOptimization<Float64, Float64> = crate::CopyOptimization<Float64, Float64>::PRIMITIVE
Source§fn encode(
self,
encoder: &mut E,
out: &mut MaybeUninit<Float64>,
constraint: <Float64 as Constrained>::Constraint,
) -> Result<(), EncodeError>
fn encode( self, encoder: &mut E, out: &mut MaybeUninit<Float64>, constraint: <Float64 as Constrained>::Constraint, ) -> Result<(), EncodeError>
Encodes this value into an encoder and output.
Source§impl<E: ?Sized> Encode<Float64, E> for f64
impl<E: ?Sized> Encode<Float64, E> for f64
Source§const COPY_OPTIMIZATION: CopyOptimization<f64, Float64> = crate::CopyOptimization<f64, Float64>::PRIMITIVE
const COPY_OPTIMIZATION: CopyOptimization<f64, Float64> = crate::CopyOptimization<f64, Float64>::PRIMITIVE
Source§fn encode(
self,
encoder: &mut E,
out: &mut MaybeUninit<Float64>,
constraint: <Float64 as Constrained>::Constraint,
) -> Result<(), EncodeError>
fn encode( self, encoder: &mut E, out: &mut MaybeUninit<Float64>, constraint: <Float64 as Constrained>::Constraint, ) -> Result<(), EncodeError>
Encodes this value into an encoder and output.
Source§impl<E> EncodeOption<Box<'static, Float64>, E> for &Float64
impl<E> EncodeOption<Box<'static, Float64>, E> for &Float64
Source§fn encode_option(
this: Option<Self>,
encoder: &mut E,
out: &mut MaybeUninit<Box<'static, Float64>>,
constraint: <Float64 as Constrained>::Constraint,
) -> Result<(), EncodeError>
fn encode_option( this: Option<Self>, encoder: &mut E, out: &mut MaybeUninit<Box<'static, Float64>>, constraint: <Float64 as Constrained>::Constraint, ) -> Result<(), EncodeError>
Encodes this optional value into an encoder and output.
Source§impl<E> EncodeOption<Box<'static, Float64>, E> for Float64
impl<E> EncodeOption<Box<'static, Float64>, E> for Float64
Source§fn encode_option(
this: Option<Self>,
encoder: &mut E,
out: &mut MaybeUninit<Box<'static, Float64>>,
constraint: <Float64 as Constrained>::Constraint,
) -> Result<(), EncodeError>
fn encode_option( this: Option<Self>, encoder: &mut E, out: &mut MaybeUninit<Box<'static, Float64>>, constraint: <Float64 as Constrained>::Constraint, ) -> Result<(), EncodeError>
Encodes this optional value into an encoder and output.
Source§impl FromBytes for Float64
impl FromBytes for Float64
Source§impl FromWireRef<Float64> for f64
impl FromWireRef<Float64> for f64
Source§fn from_wire_ref(wire: &Float64) -> Self
fn from_wire_ref(wire: &Float64) -> Self
Converts the given reference to this type.
Source§impl FromZeros for Float64
impl FromZeros for Float64
Source§fn new_zeroed() -> Selfwhere
Self: Sized,
fn new_zeroed() -> Selfwhere
Self: Sized,
Creates an instance of
Self from zeroed bytes. Read moreSource§fn new_box_zeroed() -> Result<Box<Self>, AllocError>where
Self: Sized,
fn new_box_zeroed() -> Result<Box<Self>, AllocError>where
Self: Sized,
Creates a
Box<Self> from zeroed bytes. Read moreSource§fn new_vec_zeroed(len: usize) -> Result<Vec<Self>, AllocError>where
Self: Sized,
fn new_vec_zeroed(len: usize) -> Result<Vec<Self>, AllocError>where
Self: Sized,
Creates a
Vec<Self> from zeroed bytes. Read moreSource§fn extend_vec_zeroed(
v: &mut Vec<Self>,
additional: usize,
) -> Result<(), AllocError>where
Self: Sized,
fn extend_vec_zeroed(
v: &mut Vec<Self>,
additional: usize,
) -> Result<(), AllocError>where
Self: Sized,
Extends a
Vec<Self> by pushing additional new items onto the end of
the vector. The new items are initialized with zeros.Source§impl IntoNatural for Float64
impl IntoNatural for Float64
Source§impl MulAssign<&Float64> for Float64
impl MulAssign<&Float64> for Float64
Source§fn mul_assign(&mut self, other: &Float64)
fn mul_assign(&mut self, other: &Float64)
Performs the
*= operation. Read moreSource§impl MulAssign<&f64> for Float64
impl MulAssign<&f64> for Float64
Source§fn mul_assign(&mut self, other: &f64)
fn mul_assign(&mut self, other: &f64)
Performs the
*= operation. Read moreSource§impl MulAssign<f64> for Float64
impl MulAssign<f64> for Float64
Source§fn mul_assign(&mut self, other: f64)
fn mul_assign(&mut self, other: f64)
Performs the
*= operation. Read moreSource§impl MulAssign for Float64
impl MulAssign for Float64
Source§fn mul_assign(&mut self, other: Float64)
fn mul_assign(&mut self, other: Float64)
Performs the
*= operation. Read moreSource§impl PartialOrd<f64> for Float64
impl PartialOrd<f64> for Float64
Source§impl PartialOrd for Float64
impl PartialOrd for Float64
Source§impl RemAssign<&Float64> for Float64
impl RemAssign<&Float64> for Float64
Source§fn rem_assign(&mut self, other: &Float64)
fn rem_assign(&mut self, other: &Float64)
Performs the
%= operation. Read moreSource§impl RemAssign<&f64> for Float64
impl RemAssign<&f64> for Float64
Source§fn rem_assign(&mut self, other: &f64)
fn rem_assign(&mut self, other: &f64)
Performs the
%= operation. Read moreSource§impl RemAssign<f64> for Float64
impl RemAssign<f64> for Float64
Source§fn rem_assign(&mut self, other: f64)
fn rem_assign(&mut self, other: f64)
Performs the
%= operation. Read moreSource§impl RemAssign for Float64
impl RemAssign for Float64
Source§fn rem_assign(&mut self, other: Float64)
fn rem_assign(&mut self, other: Float64)
Performs the
%= operation. Read moreSource§impl SubAssign<&Float64> for Float64
impl SubAssign<&Float64> for Float64
Source§fn sub_assign(&mut self, other: &Float64)
fn sub_assign(&mut self, other: &Float64)
Performs the
-= operation. Read moreSource§impl SubAssign<&f64> for Float64
impl SubAssign<&f64> for Float64
Source§fn sub_assign(&mut self, other: &f64)
fn sub_assign(&mut self, other: &f64)
Performs the
-= operation. Read moreSource§impl SubAssign<f64> for Float64
impl SubAssign<f64> for Float64
Source§fn sub_assign(&mut self, other: f64)
fn sub_assign(&mut self, other: f64)
Performs the
-= operation. Read moreSource§impl SubAssign for Float64
impl SubAssign for Float64
Source§fn sub_assign(&mut self, other: Float64)
fn sub_assign(&mut self, other: Float64)
Performs the
-= operation. Read moreSource§impl TryFromBytes for Float64where
f64: TryFromBytes,
impl TryFromBytes for Float64where
f64: TryFromBytes,
Source§fn try_read_from_bytes(
source: &[u8],
) -> Result<Self, ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>where
Self: Sized,
fn try_read_from_bytes(
source: &[u8],
) -> Result<Self, ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>where
Self: Sized,
Source§fn try_read_from_prefix(
source: &[u8],
) -> Result<(Self, &[u8]), ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>where
Self: Sized,
fn try_read_from_prefix(
source: &[u8],
) -> Result<(Self, &[u8]), ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>where
Self: Sized,
Source§fn try_read_from_suffix(
source: &[u8],
) -> Result<(&[u8], Self), ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>where
Self: Sized,
fn try_read_from_suffix(
source: &[u8],
) -> Result<(&[u8], Self), ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>where
Self: Sized,
Source§impl Wire for Float64
impl Wire for Float64
Source§fn zero_padding(_: &mut MaybeUninit<Self>)
fn zero_padding(_: &mut MaybeUninit<Self>)
Writes zeroes to the padding for this type, if any.
impl Copy for Float64
impl Eq for Float64
Auto Trait Implementations§
impl Freeze for Float64
impl RefUnwindSafe for Float64
impl Send for Float64
impl Sync for Float64
impl Unpin for Float64
impl UnwindSafe for Float64
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more