Struct ordered_float::NotNan
source · pub struct NotNan<T>(/* private fields */);Expand description
A wrapper around floats providing an implementation of Eq, Ord and Hash.
A NaN value cannot be stored in this type.
use ordered_float::NotNan;
let mut v = [
NotNan::new(2.0).unwrap(),
NotNan::new(1.0).unwrap(),
];
v.sort();
assert_eq!(v, [1.0, 2.0]);Because NotNan implements Ord and Eq, it can be used as a key in a HashSet,
HashMap, BTreeMap, or BTreeSet (unlike the primitive f32 or f64 types):
let mut s: HashSet<NotNan<f32>> = HashSet::new();
let key = NotNan::new(1.0).unwrap();
s.insert(key);
assert!(s.contains(&key));Arithmetic on NotNan values will panic if it produces a NaN value:
ⓘ
let a = NotNan::new(std::f32::INFINITY).unwrap();
let b = NotNan::new(std::f32::NEG_INFINITY).unwrap();
// This will panic:
let c = a + b;Implementations§
source§impl<T: Float> NotNan<T>
impl<T: Float> NotNan<T>
sourcepub fn new(val: T) -> Result<Self, FloatIsNan>
pub fn new(val: T) -> Result<Self, FloatIsNan>
Create a NotNan value.
Returns Err if val is NaN
source§impl<T> NotNan<T>
impl<T> NotNan<T>
sourcepub fn into_inner(self) -> T
pub fn into_inner(self) -> T
Get the value out.
sourcepub const unsafe fn new_unchecked(val: T) -> Self
pub const unsafe fn new_unchecked(val: T) -> Self
Create a NotNan value from a value that is guaranteed to not be NaN
Safety
Behaviour is undefined if val is NaN
sourcepub const unsafe fn unchecked_new(val: T) -> Self
👎Deprecated since 2.5.0: Please use the new_unchecked function instead.
pub const unsafe fn unchecked_new(val: T) -> Self
Create a NotNan value from a value that is guaranteed to not be NaN
Safety
Behaviour is undefined if val is NaN
Trait Implementations§
source§impl<T: Float> Add<T> for NotNan<T>
impl<T: Float> Add<T> for NotNan<T>
Adds a float directly.
Panics if the provided value is NaN or the computation results in NaN
source§impl<T: Float + AddAssign> AddAssign<&NotNan<T>> for NotNan<T>
impl<T: Float + AddAssign> AddAssign<&NotNan<T>> for NotNan<T>
source§fn add_assign(&mut self, other: &Self)
fn add_assign(&mut self, other: &Self)
Performs the
+= operation. Read moresource§impl<T: Float + AddAssign> AddAssign<&T> for NotNan<T>
impl<T: Float + AddAssign> AddAssign<&T> for NotNan<T>
source§fn add_assign(&mut self, other: &T)
fn add_assign(&mut self, other: &T)
Performs the
+= operation. Read moresource§impl<T: Float + AddAssign> AddAssign<T> for NotNan<T>
impl<T: Float + AddAssign> AddAssign<T> for NotNan<T>
source§fn add_assign(&mut self, other: T)
fn add_assign(&mut self, other: T)
Performs the
+= operation. Read moresource§impl<T: Float + AddAssign> AddAssign for NotNan<T>
impl<T: Float + AddAssign> AddAssign for NotNan<T>
source§fn add_assign(&mut self, other: Self)
fn add_assign(&mut self, other: Self)
Performs the
+= operation. Read moresource§impl<T: Float> Div<T> for NotNan<T>
impl<T: Float> Div<T> for NotNan<T>
Divides a float directly.
Panics if the provided value is NaN or the computation results in NaN
source§impl<T: Float + DivAssign> DivAssign<&NotNan<T>> for NotNan<T>
impl<T: Float + DivAssign> DivAssign<&NotNan<T>> for NotNan<T>
source§fn div_assign(&mut self, other: &Self)
fn div_assign(&mut self, other: &Self)
Performs the
/= operation. Read moresource§impl<T: Float + DivAssign> DivAssign<&T> for NotNan<T>
impl<T: Float + DivAssign> DivAssign<&T> for NotNan<T>
source§fn div_assign(&mut self, other: &T)
fn div_assign(&mut self, other: &T)
Performs the
/= operation. Read moresource§impl<T: Float + DivAssign> DivAssign<T> for NotNan<T>
impl<T: Float + DivAssign> DivAssign<T> for NotNan<T>
source§fn div_assign(&mut self, other: T)
fn div_assign(&mut self, other: T)
Performs the
/= operation. Read moresource§impl<T: Float + DivAssign> DivAssign for NotNan<T>
impl<T: Float + DivAssign> DivAssign for NotNan<T>
source§fn div_assign(&mut self, other: Self)
fn div_assign(&mut self, other: Self)
Performs the
/= operation. Read moresource§impl<T: FloatConst> FloatConst for NotNan<T>
impl<T: FloatConst> FloatConst for NotNan<T>
source§fn FRAC_1_SQRT_2() -> Self
fn FRAC_1_SQRT_2() -> Self
Return
1.0 / sqrt(2.0).source§fn FRAC_2_SQRT_PI() -> Self
fn FRAC_2_SQRT_PI() -> Self
Return
2.0 / sqrt(π).source§impl<T: Float + FromPrimitive> FromPrimitive for NotNan<T>
impl<T: Float + FromPrimitive> FromPrimitive for NotNan<T>
source§fn from_i64(n: i64) -> Option<Self>
fn from_i64(n: i64) -> Option<Self>
Converts an
i64 to return an optional value of this type. If the
value cannot be represented by this type, then None is returned.source§fn from_u64(n: u64) -> Option<Self>
fn from_u64(n: u64) -> Option<Self>
Converts an
u64 to return an optional value of this type. If the
value cannot be represented by this type, then None is returned.source§fn from_isize(n: isize) -> Option<Self>
fn from_isize(n: isize) -> Option<Self>
Converts an
isize to return an optional value of this type. If the
value cannot be represented by this type, then None is returned.source§fn from_i8(n: i8) -> Option<Self>
fn from_i8(n: i8) -> Option<Self>
Converts an
i8 to return an optional value of this type. If the
value cannot be represented by this type, then None is returned.source§fn from_i16(n: i16) -> Option<Self>
fn from_i16(n: i16) -> Option<Self>
Converts an
i16 to return an optional value of this type. If the
value cannot be represented by this type, then None is returned.source§fn from_i32(n: i32) -> Option<Self>
fn from_i32(n: i32) -> Option<Self>
Converts an
i32 to return an optional value of this type. If the
value cannot be represented by this type, then None is returned.source§fn from_usize(n: usize) -> Option<Self>
fn from_usize(n: usize) -> Option<Self>
Converts a
usize to return an optional value of this type. If the
value cannot be represented by this type, then None is returned.source§fn from_u8(n: u8) -> Option<Self>
fn from_u8(n: u8) -> Option<Self>
Converts an
u8 to return an optional value of this type. If the
value cannot be represented by this type, then None is returned.source§fn from_u16(n: u16) -> Option<Self>
fn from_u16(n: u16) -> Option<Self>
Converts an
u16 to return an optional value of this type. If the
value cannot be represented by this type, then None is returned.source§fn from_u32(n: u32) -> Option<Self>
fn from_u32(n: u32) -> Option<Self>
Converts an
u32 to return an optional value of this type. If the
value cannot be represented by this type, then None is returned.source§fn from_f32(n: f32) -> Option<Self>
fn from_f32(n: f32) -> Option<Self>
Converts a
f32 to return an optional value of this type. If the
value cannot be represented by this type, then None is returned.source§fn from_f64(n: f64) -> Option<Self>
fn from_f64(n: f64) -> Option<Self>
Converts a
f64 to return an optional value of this type. If the
value cannot be represented by this type, then None is returned. Read moresource§impl<T: Float + FromStr> FromStr for NotNan<T>
impl<T: Float + FromStr> FromStr for NotNan<T>
source§fn from_str(src: &str) -> Result<Self, Self::Err>
fn from_str(src: &str) -> Result<Self, Self::Err>
Convert a &str to NotNan. Returns an error if the string fails to parse,
or if the resulting value is NaN
use ordered_float::NotNan;
assert!("-10".parse::<NotNan<f32>>().is_ok());
assert!("abc".parse::<NotNan<f32>>().is_err());
assert!("NaN".parse::<NotNan<f32>>().is_err());§type Err = ParseNotNanError<<T as FromStr>::Err>
type Err = ParseNotNanError<<T as FromStr>::Err>
The associated error which can be returned from parsing.
source§impl<T: Float> Mul<T> for NotNan<T>
impl<T: Float> Mul<T> for NotNan<T>
Multiplies a float directly.
Panics if the provided value is NaN or the computation results in NaN
source§impl<T: Float + MulAssign> MulAssign<&NotNan<T>> for NotNan<T>
impl<T: Float + MulAssign> MulAssign<&NotNan<T>> for NotNan<T>
source§fn mul_assign(&mut self, other: &Self)
fn mul_assign(&mut self, other: &Self)
Performs the
*= operation. Read moresource§impl<T: Float + MulAssign> MulAssign<&T> for NotNan<T>
impl<T: Float + MulAssign> MulAssign<&T> for NotNan<T>
source§fn mul_assign(&mut self, other: &T)
fn mul_assign(&mut self, other: &T)
Performs the
*= operation. Read moresource§impl<T: Float + MulAssign> MulAssign<T> for NotNan<T>
impl<T: Float + MulAssign> MulAssign<T> for NotNan<T>
source§fn mul_assign(&mut self, other: T)
fn mul_assign(&mut self, other: T)
Performs the
*= operation. Read moresource§impl<T: Float + MulAssign> MulAssign for NotNan<T>
impl<T: Float + MulAssign> MulAssign for NotNan<T>
source§fn mul_assign(&mut self, other: Self)
fn mul_assign(&mut self, other: Self)
Performs the
*= operation. Read moresource§impl<T: Float> Num for NotNan<T>
impl<T: Float> Num for NotNan<T>
type FromStrRadixErr = ParseNotNanError<<T as Num>::FromStrRadixErr>
source§fn from_str_radix(src: &str, radix: u32) -> Result<Self, Self::FromStrRadixErr>
fn from_str_radix(src: &str, radix: u32) -> Result<Self, Self::FromStrRadixErr>
Convert from a string and radix (typically
2..=36). Read moresource§impl<T: Float> Ord for NotNan<T>
impl<T: Float> Ord for NotNan<T>
source§impl<T: PartialEq> PartialEq for NotNan<T>
impl<T: PartialEq> PartialEq for NotNan<T>
source§impl<T: PartialOrd> PartialOrd for NotNan<T>
impl<T: PartialOrd> PartialOrd for NotNan<T>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for
self and other) and is used by the <=
operator. Read moresource§impl<T: Float> Rem<T> for NotNan<T>
impl<T: Float> Rem<T> for NotNan<T>
Calculates % with a float directly.
Panics if the provided value is NaN or the computation results in NaN
source§impl<T: Float + RemAssign> RemAssign<&NotNan<T>> for NotNan<T>
impl<T: Float + RemAssign> RemAssign<&NotNan<T>> for NotNan<T>
source§fn rem_assign(&mut self, other: &Self)
fn rem_assign(&mut self, other: &Self)
Performs the
%= operation. Read moresource§impl<T: Float + RemAssign> RemAssign<&T> for NotNan<T>
impl<T: Float + RemAssign> RemAssign<&T> for NotNan<T>
source§fn rem_assign(&mut self, other: &T)
fn rem_assign(&mut self, other: &T)
Performs the
%= operation. Read moresource§impl<T: Float + RemAssign> RemAssign<T> for NotNan<T>
impl<T: Float + RemAssign> RemAssign<T> for NotNan<T>
source§fn rem_assign(&mut self, other: T)
fn rem_assign(&mut self, other: T)
Performs the
%= operation. Read moresource§impl<T: Float + RemAssign> RemAssign for NotNan<T>
impl<T: Float + RemAssign> RemAssign for NotNan<T>
source§fn rem_assign(&mut self, other: Self)
fn rem_assign(&mut self, other: Self)
Performs the
%= operation. Read moresource§impl<T: Float + Signed> Signed for NotNan<T>
impl<T: Float + Signed> Signed for NotNan<T>
source§fn is_positive(&self) -> bool
fn is_positive(&self) -> bool
Returns true if the number is positive and false if the number is zero or negative.
source§fn is_negative(&self) -> bool
fn is_negative(&self) -> bool
Returns true if the number is negative and false if the number is zero or positive.
source§impl<T: Float> Sub<T> for NotNan<T>
impl<T: Float> Sub<T> for NotNan<T>
Subtracts a float directly.
Panics if the provided value is NaN or the computation results in NaN
source§impl<T: Float + SubAssign> SubAssign<&NotNan<T>> for NotNan<T>
impl<T: Float + SubAssign> SubAssign<&NotNan<T>> for NotNan<T>
source§fn sub_assign(&mut self, other: &Self)
fn sub_assign(&mut self, other: &Self)
Performs the
-= operation. Read moresource§impl<T: Float + SubAssign> SubAssign<&T> for NotNan<T>
impl<T: Float + SubAssign> SubAssign<&T> for NotNan<T>
source§fn sub_assign(&mut self, other: &T)
fn sub_assign(&mut self, other: &T)
Performs the
-= operation. Read moresource§impl<T: Float + SubAssign> SubAssign<T> for NotNan<T>
impl<T: Float + SubAssign> SubAssign<T> for NotNan<T>
source§fn sub_assign(&mut self, other: T)
fn sub_assign(&mut self, other: T)
Performs the
-= operation. Read moresource§impl<T: Float + SubAssign> SubAssign for NotNan<T>
impl<T: Float + SubAssign> SubAssign for NotNan<T>
source§fn sub_assign(&mut self, other: Self)
fn sub_assign(&mut self, other: Self)
Performs the
-= operation. Read moresource§impl<T: Float + Sum> Sum for NotNan<T>
impl<T: Float + Sum> Sum for NotNan<T>
Adds a float directly.
Panics if the provided value is NaN.
source§impl<T: Float> ToPrimitive for NotNan<T>
impl<T: Float> ToPrimitive for NotNan<T>
source§fn to_i64(&self) -> Option<i64>
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.source§fn to_u64(&self) -> Option<u64>
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.source§fn to_isize(&self) -> Option<isize>
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.source§fn to_i8(&self) -> Option<i8>
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.source§fn to_i16(&self) -> Option<i16>
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.source§fn to_i32(&self) -> Option<i32>
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.source§fn to_usize(&self) -> Option<usize>
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.source§fn to_u8(&self) -> Option<u8>
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.source§fn to_u16(&self) -> Option<u16>
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.source§fn to_u32(&self) -> Option<u32>
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.source§fn to_f32(&self) -> Option<f32>
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.source§fn to_f64(&self) -> Option<f64>
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. Read moreimpl<T: Copy> Copy for NotNan<T>
impl<T: Float + PartialEq> Eq for NotNan<T>
impl<T> StructuralPartialEq for NotNan<T>
Auto Trait Implementations§
impl<T> RefUnwindSafe for NotNan<T>where
T: RefUnwindSafe,
impl<T> Send for NotNan<T>where
T: Send,
impl<T> Sync for NotNan<T>where
T: Sync,
impl<T> Unpin for NotNan<T>where
T: Unpin,
impl<T> UnwindSafe for NotNan<T>where
T: UnwindSafe,
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