pub struct NotNan<T>(/* private fields */);
Expand description
The type used for float fields that are never NaN.
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> NotNan<T>where
T: Float,
impl<T> NotNan<T>where
T: Float,
Sourcepub fn new(val: T) -> Result<NotNan<T>, FloatIsNan>
pub fn new(val: T) -> Result<NotNan<T>, 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 unchecked_new(val: T) -> NotNan<T>
👎Deprecated since 2.5.0: Please use the new_unchecked function instead.
pub const unsafe fn unchecked_new(val: T) -> NotNan<T>
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 new_unchecked(val: T) -> NotNan<T>
pub const unsafe fn new_unchecked(val: T) -> NotNan<T>
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> Add<T> for NotNan<T>where
T: Float,
Adds a float directly.
impl<T> Add<T> for NotNan<T>where
T: Float,
Adds a float directly.
Panics if the provided value is NaN or the computation results in NaN
Source§impl<T> AddAssign<&NotNan<T>> for NotNan<T>
impl<T> AddAssign<&NotNan<T>> for NotNan<T>
Source§fn add_assign(&mut self, other: &NotNan<T>)
fn add_assign(&mut self, other: &NotNan<T>)
+=
operation. Read moreSource§impl<T> AddAssign<&T> for NotNan<T>
impl<T> AddAssign<&T> for NotNan<T>
Source§fn add_assign(&mut self, other: &T)
fn add_assign(&mut self, other: &T)
+=
operation. Read moreSource§impl<T> AddAssign<T> for NotNan<T>
impl<T> AddAssign<T> for NotNan<T>
Source§fn add_assign(&mut self, other: T)
fn add_assign(&mut self, other: T)
+=
operation. Read moreSource§impl<T> AddAssign for NotNan<T>
impl<T> AddAssign for NotNan<T>
Source§fn add_assign(&mut self, other: NotNan<T>)
fn add_assign(&mut self, other: NotNan<T>)
+=
operation. Read moreSource§impl<T> Div<T> for NotNan<T>where
T: Float,
Divides a float directly.
impl<T> Div<T> for NotNan<T>where
T: Float,
Divides a float directly.
Panics if the provided value is NaN or the computation results in NaN
Source§impl<T> DivAssign<&NotNan<T>> for NotNan<T>
impl<T> DivAssign<&NotNan<T>> for NotNan<T>
Source§fn div_assign(&mut self, other: &NotNan<T>)
fn div_assign(&mut self, other: &NotNan<T>)
/=
operation. Read moreSource§impl<T> DivAssign<&T> for NotNan<T>
impl<T> DivAssign<&T> for NotNan<T>
Source§fn div_assign(&mut self, other: &T)
fn div_assign(&mut self, other: &T)
/=
operation. Read moreSource§impl<T> DivAssign<T> for NotNan<T>
impl<T> DivAssign<T> for NotNan<T>
Source§fn div_assign(&mut self, other: T)
fn div_assign(&mut self, other: T)
/=
operation. Read moreSource§impl<T> DivAssign for NotNan<T>
impl<T> DivAssign for NotNan<T>
Source§fn div_assign(&mut self, other: NotNan<T>)
fn div_assign(&mut self, other: NotNan<T>)
/=
operation. Read moreSource§impl<T> FromPrimitive for NotNan<T>where
T: Float + FromPrimitive,
impl<T> FromPrimitive for NotNan<T>where
T: Float + FromPrimitive,
Source§fn from_i64(n: i64) -> Option<NotNan<T>>
fn from_i64(n: i64) -> Option<NotNan<T>>
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<NotNan<T>>
fn from_u64(n: u64) -> Option<NotNan<T>>
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<NotNan<T>>
fn from_isize(n: isize) -> Option<NotNan<T>>
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<NotNan<T>>
fn from_i8(n: i8) -> Option<NotNan<T>>
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<NotNan<T>>
fn from_i16(n: i16) -> Option<NotNan<T>>
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<NotNan<T>>
fn from_i32(n: i32) -> Option<NotNan<T>>
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<NotNan<T>>
fn from_usize(n: usize) -> Option<NotNan<T>>
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<NotNan<T>>
fn from_u8(n: u8) -> Option<NotNan<T>>
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<NotNan<T>>
fn from_u16(n: u16) -> Option<NotNan<T>>
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<NotNan<T>>
fn from_u32(n: u32) -> Option<NotNan<T>>
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<NotNan<T>>
fn from_f32(n: f32) -> Option<NotNan<T>>
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<NotNan<T>>
fn from_f64(n: f64) -> Option<NotNan<T>>
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<'a> FromSql<'a> for NotNan<f32>
Parses an f32
and wraps it with NotNan::new_unchecked
.
impl<'a> FromSql<'a> for NotNan<f32>
Parses an f32
and wraps it with NotNan::new_unchecked
.
§Safety
This will never accidentally wrap a NaN
because nom
’s recognize_float
doesn’t include a representation of NaN
.
Source§impl<'a> FromSql<'a> for NotNan<f64>
Parses an f64
and wraps it with NotNan::new_unchecked
.
impl<'a> FromSql<'a> for NotNan<f64>
Parses an f64
and wraps it with NotNan::new_unchecked
.
§Safety
This will never accidentally wrap a NaN
because nom
’s recognize_float
doesn’t include a representation of NaN
.
Source§impl<T> FromStr for NotNan<T>
impl<T> FromStr for NotNan<T>
Source§fn from_str(src: &str) -> Result<NotNan<T>, <NotNan<T> as FromStr>::Err>
fn from_str(src: &str) -> Result<NotNan<T>, <NotNan<T> as FromStr>::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());
Source§impl<T> Mul<T> for NotNan<T>where
T: Float,
Multiplies a float directly.
impl<T> Mul<T> for NotNan<T>where
T: Float,
Multiplies a float directly.
Panics if the provided value is NaN or the computation results in NaN
Source§impl<T> MulAssign<&NotNan<T>> for NotNan<T>
impl<T> MulAssign<&NotNan<T>> for NotNan<T>
Source§fn mul_assign(&mut self, other: &NotNan<T>)
fn mul_assign(&mut self, other: &NotNan<T>)
*=
operation. Read moreSource§impl<T> MulAssign<&T> for NotNan<T>
impl<T> MulAssign<&T> for NotNan<T>
Source§fn mul_assign(&mut self, other: &T)
fn mul_assign(&mut self, other: &T)
*=
operation. Read moreSource§impl<T> MulAssign<T> for NotNan<T>
impl<T> MulAssign<T> for NotNan<T>
Source§fn mul_assign(&mut self, other: T)
fn mul_assign(&mut self, other: T)
*=
operation. Read moreSource§impl<T> MulAssign for NotNan<T>
impl<T> MulAssign for NotNan<T>
Source§fn mul_assign(&mut self, other: NotNan<T>)
fn mul_assign(&mut self, other: NotNan<T>)
*=
operation. Read moreSource§impl<T> Num for NotNan<T>where
T: Float,
impl<T> Num for NotNan<T>where
T: Float,
type FromStrRadixErr = ParseNotNanError<<T as Num>::FromStrRadixErr>
Source§impl<T> Ord for NotNan<T>where
T: Float,
impl<T> Ord for NotNan<T>where
T: Float,
Source§impl<T> PartialOrd for NotNan<T>where
T: PartialOrd,
impl<T> PartialOrd for NotNan<T>where
T: PartialOrd,
Source§impl<T> Rem<T> for NotNan<T>where
T: Float,
Calculates %
with a float directly.
impl<T> Rem<T> for NotNan<T>where
T: Float,
Calculates %
with a float directly.
Panics if the provided value is NaN or the computation results in NaN
Source§impl<T> RemAssign<&NotNan<T>> for NotNan<T>
impl<T> RemAssign<&NotNan<T>> for NotNan<T>
Source§fn rem_assign(&mut self, other: &NotNan<T>)
fn rem_assign(&mut self, other: &NotNan<T>)
%=
operation. Read moreSource§impl<T> RemAssign<&T> for NotNan<T>
impl<T> RemAssign<&T> for NotNan<T>
Source§fn rem_assign(&mut self, other: &T)
fn rem_assign(&mut self, other: &T)
%=
operation. Read moreSource§impl<T> RemAssign<T> for NotNan<T>
impl<T> RemAssign<T> for NotNan<T>
Source§fn rem_assign(&mut self, other: T)
fn rem_assign(&mut self, other: T)
%=
operation. Read moreSource§impl<T> RemAssign for NotNan<T>
impl<T> RemAssign for NotNan<T>
Source§fn rem_assign(&mut self, other: NotNan<T>)
fn rem_assign(&mut self, other: NotNan<T>)
%=
operation. Read moreSource§impl SampleUniform for NotNan<f32>
impl SampleUniform for NotNan<f32>
Source§impl SampleUniform for NotNan<f64>
impl SampleUniform for NotNan<f64>
Source§impl<T> Signed for NotNan<T>
impl<T> Signed for NotNan<T>
Source§fn abs_sub(&self, other: &NotNan<T>) -> NotNan<T>
fn abs_sub(&self, other: &NotNan<T>) -> NotNan<T>
Source§fn is_positive(&self) -> bool
fn is_positive(&self) -> bool
Source§fn is_negative(&self) -> bool
fn is_negative(&self) -> bool
Source§impl<T> Sub<T> for NotNan<T>where
T: Float,
Subtracts a float directly.
impl<T> Sub<T> for NotNan<T>where
T: Float,
Subtracts a float directly.
Panics if the provided value is NaN or the computation results in NaN
Source§impl<T> SubAssign<&NotNan<T>> for NotNan<T>
impl<T> SubAssign<&NotNan<T>> for NotNan<T>
Source§fn sub_assign(&mut self, other: &NotNan<T>)
fn sub_assign(&mut self, other: &NotNan<T>)
-=
operation. Read moreSource§impl<T> SubAssign<&T> for NotNan<T>
impl<T> SubAssign<&T> for NotNan<T>
Source§fn sub_assign(&mut self, other: &T)
fn sub_assign(&mut self, other: &T)
-=
operation. Read moreSource§impl<T> SubAssign<T> for NotNan<T>
impl<T> SubAssign<T> for NotNan<T>
Source§fn sub_assign(&mut self, other: T)
fn sub_assign(&mut self, other: T)
-=
operation. Read moreSource§impl<T> SubAssign for NotNan<T>
impl<T> SubAssign for NotNan<T>
Source§fn sub_assign(&mut self, other: NotNan<T>)
fn sub_assign(&mut self, other: NotNan<T>)
-=
operation. Read moreSource§impl<T> ToPrimitive for NotNan<T>where
T: Float,
impl<T> ToPrimitive for NotNan<T>where
T: Float,
Source§fn to_i64(&self) -> Option<i64>
fn to_i64(&self) -> Option<i64>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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 for NotNan<T>where
T: Copy,
impl<T> Eq for NotNan<T>
impl<T> StructuralPartialEq for NotNan<T>
Auto Trait Implementations§
impl<T> Freeze for NotNan<T>where
T: Freeze,
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
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<Borrowed> SampleBorrow<Borrowed> for Borrowedwhere
Borrowed: SampleUniform,
impl<Borrowed> SampleBorrow<Borrowed> for Borrowedwhere
Borrowed: SampleUniform,
Source§fn borrow(&self) -> &Borrowed
fn borrow(&self) -> &Borrowed
Borrow::borrow