blockworks-foundation
/
fixed
mirror of https://github.com/blockworks-foundation/fixed.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: link to F::is_{finite,nan} in impl {To,From}Fixed for F 

Before this commit, all links were to the f64 documentation, even for
implementations for f32, f16 and bf16.
This commit is contained in:
Trevor Spiteri 2020-03-20 01:59:51 +01:00
parent f86e59a204
commit 8803e0786d
1 changed files with 87 additions and 77 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

164
src/traits.rs
View File

@ -1510,7 +1510,7 @@ impl_int! { u128 }
impl_int! { usize } impl_int! { usize }
macro_rules! impl_float { macro_rules! impl_float {
($Float:ty) => { ($Float:ty, $link:expr) => {
impl FromFixed for $Float { impl FromFixed for $Float {
/// Converts a fixed-point number to a floating-point number. /// Converts a fixed-point number to a floating-point number.
/// ///
@ -1578,29 +1578,30 @@ macro_rules! impl_float {
} }
impl ToFixed for $Float { impl ToFixed for $Float {
/// Converts a floating-point number to a fixed-point number. comment! {
/// "Converts a floating-point number to a fixed-point number.
/// Rounding is to the nearest, with ties rounded to even.
/// Rounding is to the nearest, with ties rounded to even.
/// # Panics
/// # Panics
/// Panics if `self` is not [finite].
/// Panics if `self` is not [finite].
/// When debug assertions are enabled, also panics if the
/// value does not fit. When debug assertions are not When debug assertions are enabled, also panics if the value does not
/// enabled, the wrapped value can be returned, but it is fit. When debug assertions are not enabled, the wrapped value can be
/// not considered a breaking change if in the future it returned, but it is not considered a breaking change if in the future
/// panics; if wrapping is required use it panics; if wrapping is required use [`wrapping_to_fixed`] instead.
/// [`wrapping_to_fixed`] instead.
/// [`wrapping_to_fixed`]: #method.wrapping_to_fixed
/// [`wrapping_to_fixed`]: #method.wrapping_to_fixed [finite]: ", $link, "#method.is_finite
/// [finite]: https://doc.rust-lang.org/nightly/std/primitive.f64.html#method.is_finite ";
#[inline] #[inline]
fn to_fixed<F: Fixed>(self) -> F { fn to_fixed<F: Fixed>(self) -> F {
let (wrapped, overflow) = ToFixed::overflowing_to_fixed(self); let (wrapped, overflow) = ToFixed::overflowing_to_fixed(self);
debug_assert!(!overflow, "{} overflows", self); debug_assert!(!overflow, "{} overflows", self);
let _ = overflow; let _ = overflow;
wrapped wrapped
}
} }
/// Converts a floating-point number to a fixed-point /// Converts a floating-point number to a fixed-point
@ -1624,70 +1625,79 @@ macro_rules! impl_float {
} }
} }
/// Converts a floating-point number to a fixed-point comment! {
/// number, saturating if it does not fit. "Converts a floating-point number to a fixed-point
/// number, saturating if it does not fit.
/// Rounding is to the nearest, with ties rounded to even.
/// Rounding is to the nearest, with ties rounded to even.
/// # Panics
/// # Panics
/// Panics if `self` is [NaN].
/// Panics if `self` is [NaN].
/// [NaN]: https://doc.rust-lang.org/nightly/std/primitive.f64.html#method.is_nan
#[inline] [NaN]: ", $link, "#method.is_nan
fn saturating_to_fixed<F: Fixed>(self) -> F { ";
let kind = self.to_float_kind(F::frac_nbits(), F::int_nbits()); #[inline]
let helper = FromFloatHelper { kind }; fn saturating_to_fixed<F: Fixed>(self) -> F {
F::private_saturating_from_float_helper(helper) let kind = self.to_float_kind(F::frac_nbits(), F::int_nbits());
let helper = FromFloatHelper { kind };
F::private_saturating_from_float_helper(helper)
}
} }
/// Converts a floating-point number to a fixed-point comment! {
/// number, wrapping if it does not fit. "Converts a floating-point number to a fixed-point
/// number, wrapping if it does not fit.
/// Rounding is to the nearest, with ties rounded to even.
/// Rounding is to the nearest, with ties rounded to even.
/// # Panics
/// # Panics
/// Panics if `self` is not [finite].
/// Panics if `self` is not [finite].
/// [finite]: https://doc.rust-lang.org/nightly/std/primitive.f64.html#method.is_finite
#[inline] [finite]: ", $link, "#method.is_finite
fn wrapping_to_fixed<F: Fixed>(self) -> F { ";
let (wrapped, _) = ToFixed::overflowing_to_fixed(self); #[inline]
wrapped fn wrapping_to_fixed<F: Fixed>(self) -> F {
let (wrapped, _) = ToFixed::overflowing_to_fixed(self);
wrapped
}
} }
/// Converts a floating-point number to a fixed-point number. comment! {
/// "Converts a floating-point number to a fixed-point number.
/// Returns a [tuple] of the fixed-point number and a [`bool`]
/// indicating whether an overflow has occurred. On overflow, the Returns a [tuple] of the fixed-point number and a [`bool`] indicating
/// wrapped value is returned. whether an overflow has occurred. On overflow, the wrapped value is
/// returned.
/// Rounding is to the nearest, with ties rounded to even.
/// Rounding is to the nearest, with ties rounded to even.
/// # Panics
/// # Panics
/// Panics if `self` is not [finite].
/// Panics if `self` is not [finite].
/// [`bool`]: https://doc.rust-lang.org/nightly/std/primitive.bool.html
/// [finite]: https://doc.rust-lang.org/nightly/std/primitive.f64.html#method.is_finite [`bool`]: https://doc.rust-lang.org/nightly/std/primitive.bool.html
/// [tuple]: https://doc.rust-lang.org/nightly/std/primitive.tuple.html [finite]: ", $link, "#method.is_finite
#[inline] [tuple]: https://doc.rust-lang.org/nightly/std/primitive.tuple.html
fn overflowing_to_fixed<F: Fixed>(self) -> (F, bool) { ";
let kind = self.to_float_kind(F::frac_nbits(), F::int_nbits()); #[inline]
let helper = FromFloatHelper { kind }; fn overflowing_to_fixed<F: Fixed>(self) -> (F, bool) {
F::private_overflowing_from_float_helper(helper) let kind = self.to_float_kind(F::frac_nbits(), F::int_nbits());
let helper = FromFloatHelper { kind };
F::private_overflowing_from_float_helper(helper)
}
} }
} }
}; };
} }
#[cfg(feature = "f16")] #[cfg(feature = "f16")]
impl_float! { f16 } impl_float! { f16, "https://docs.rs/half/^1/half/struct.f16.html" }
#[cfg(feature = "f16")] #[cfg(feature = "f16")]
impl_float! { bf16 } impl_float! { bf16, "https://docs.rs/half/^1/half/struct.bf16.html" }
impl_float! { f32 } impl_float! { f32, "https://doc.rust-lang.org/nightly/std/primitive.f32.html" }
impl_float! { f64 } impl_float! { f64, "https://doc.rust-lang.org/nightly/std/primitive.f64.html" }
macro_rules! trait_delegate { macro_rules! trait_delegate {
(fn $method:ident($($param:ident: $Param:ty),*) -> $Ret:ty) => { (fn $method:ident($($param:ident: $Param:ty),*) -> $Ret:ty) => {