Trait ConvFloat

pub trait ConvFloat<T>: Sized {
    // Required methods
    fn try_conv_trunc(x: T) -> Result<Self>;
    fn try_conv_nearest(x: T) -> Result<Self>;
    fn try_conv_floor(x: T) -> Result<Self>;
    fn try_conv_ceil(x: T) -> Result<Self>;

    // Provided methods
    fn conv_trunc(x: T) -> Self { ... }
    fn conv_nearest(x: T) -> Self { ... }
    fn conv_floor(x: T) -> Self { ... }
    fn conv_ceil(x: T) -> Self { ... }
}

Available on crate features std or libm only.

Nearest / floor / ceiling conversions from floating point types

This trait is explicitly for conversions from floating-point values to integers, supporting four rounding modes.

As with Conv, the try_conv_* methods must be implemented and must fail if conversion to the expected value is not possible. If the source is non- finite (inf or NaN), then Error::Range should be returned.

The conv_* methods each have a default implementation over the try_.. variant which panics on failure. Implementations handle errors as follows:

• In debug builds, the methods must panic
• Otherwise, the method may panic or may return a different value; all results must be well-defined and safe.
• Implementations provided by this library will also panic if the always_assert or assert_float feature flag is used.

The sister-trait CastFloat supports “into” style usage.

Required Methods

fn try_conv_trunc(x: T) -> Result<Self>

Try converting to integer with truncation

Rounds towards zero (same as as).

fn try_conv_nearest(x: T) -> Result<Self>

Try converting to the nearest integer

Half-way cases are rounded away from 0.

fn try_conv_floor(x: T) -> Result<Self>

Try converting the floor to an integer

Returns the largest integer less than or equal to x.

fn try_conv_ceil(x: T) -> Result<Self>

Try convert the ceiling to an integer

Returns the smallest integer greater than or equal to x.

Provided Methods

fn conv_trunc(x: T) -> Self

Convert to integer with truncatation

Rounds towards zero (same as as).

fn conv_nearest(x: T) -> Self

Convert to the nearest integer

Half-way cases are rounded away from 0.

fn conv_floor(x: T) -> Self

Convert the floor to an integer

Returns the largest integer less than or equal to x.

fn conv_ceil(x: T) -> Self

Convert the ceiling to an integer

Returns the smallest integer greater than or equal to x.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl ConvFloat<f32> for i8

fn conv_trunc(x: f32) -> i8

Available on crate features std or libm only.

fn conv_nearest(x: f32) -> i8

Available on crate features std or libm only.

fn conv_floor(x: f32) -> i8

Available on crate features std or libm only.

fn conv_ceil(x: f32) -> i8

Available on crate features std or libm only.

fn try_conv_trunc(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f32) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f32> for i16

fn conv_trunc(x: f32) -> i16

Available on crate features std or libm only.

fn conv_nearest(x: f32) -> i16

Available on crate features std or libm only.

fn conv_floor(x: f32) -> i16

Available on crate features std or libm only.

fn conv_ceil(x: f32) -> i16

Available on crate features std or libm only.

fn try_conv_trunc(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f32) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f32> for i32

fn conv_trunc(x: f32) -> i32

Available on crate features std or libm only.

fn conv_nearest(x: f32) -> i32

Available on crate features std or libm only.

fn conv_floor(x: f32) -> i32

Available on crate features std or libm only.

fn conv_ceil(x: f32) -> i32

Available on crate features std or libm only.

fn try_conv_trunc(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f32) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f32> for i64

fn conv_trunc(x: f32) -> i64

Available on crate features std or libm only.

fn conv_nearest(x: f32) -> i64

Available on crate features std or libm only.

fn conv_floor(x: f32) -> i64

Available on crate features std or libm only.

fn conv_ceil(x: f32) -> i64

Available on crate features std or libm only.

fn try_conv_trunc(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f32) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f32> for i128

fn conv_trunc(x: f32) -> i128

Available on crate features std or libm only.

fn conv_nearest(x: f32) -> i128

Available on crate features std or libm only.

fn conv_floor(x: f32) -> i128

Available on crate features std or libm only.

fn conv_ceil(x: f32) -> i128

Available on crate features std or libm only.

fn try_conv_trunc(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f32) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f32> for isize

fn conv_trunc(x: f32) -> isize

Available on crate features std or libm only.

fn conv_nearest(x: f32) -> isize

Available on crate features std or libm only.

fn conv_floor(x: f32) -> isize

Available on crate features std or libm only.

fn conv_ceil(x: f32) -> isize

Available on crate features std or libm only.

fn try_conv_trunc(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f32) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f32> for u8

fn conv_trunc(x: f32) -> u8

Available on crate features std or libm only.

fn conv_nearest(x: f32) -> u8

Available on crate features std or libm only.

fn conv_floor(x: f32) -> u8

Available on crate features std or libm only.

fn conv_ceil(x: f32) -> u8

Available on crate features std or libm only.

fn try_conv_trunc(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f32) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f32> for u16

fn conv_trunc(x: f32) -> u16

Available on crate features std or libm only.

fn conv_nearest(x: f32) -> u16

Available on crate features std or libm only.

fn conv_floor(x: f32) -> u16

Available on crate features std or libm only.

fn conv_ceil(x: f32) -> u16

Available on crate features std or libm only.

fn try_conv_trunc(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f32) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f32> for u32

fn conv_trunc(x: f32) -> u32

Available on crate features std or libm only.

fn conv_nearest(x: f32) -> u32

Available on crate features std or libm only.

fn conv_floor(x: f32) -> u32

Available on crate features std or libm only.

fn conv_ceil(x: f32) -> u32

Available on crate features std or libm only.

fn try_conv_trunc(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f32) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f32> for u64

fn conv_trunc(x: f32) -> u64

Available on crate features std or libm only.

fn conv_nearest(x: f32) -> u64

Available on crate features std or libm only.

fn conv_floor(x: f32) -> u64

Available on crate features std or libm only.

fn conv_ceil(x: f32) -> u64

Available on crate features std or libm only.

fn try_conv_trunc(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f32) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f32> for u128

fn conv_trunc(x: f32) -> u128

fn conv_nearest(x: f32) -> u128

fn conv_floor(x: f32) -> u128

fn conv_ceil(x: f32) -> u128

fn try_conv_trunc(x: f32) -> Result<Self>

fn try_conv_nearest(x: f32) -> Result<Self>

fn try_conv_floor(x: f32) -> Result<Self>

fn try_conv_ceil(x: f32) -> Result<Self>

impl ConvFloat<f32> for usize

fn conv_trunc(x: f32) -> usize

Available on crate features std or libm only.

fn conv_nearest(x: f32) -> usize

Available on crate features std or libm only.

fn conv_floor(x: f32) -> usize

Available on crate features std or libm only.

fn conv_ceil(x: f32) -> usize

Available on crate features std or libm only.

fn try_conv_trunc(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f32) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f32) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f64> for i8

fn conv_trunc(x: f64) -> i8

Available on crate features std or libm only.

fn conv_nearest(x: f64) -> i8

Available on crate features std or libm only.

fn conv_floor(x: f64) -> i8

Available on crate features std or libm only.

fn conv_ceil(x: f64) -> i8

Available on crate features std or libm only.

fn try_conv_trunc(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f64) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f64> for i16

fn conv_trunc(x: f64) -> i16

Available on crate features std or libm only.

fn conv_nearest(x: f64) -> i16

Available on crate features std or libm only.

fn conv_floor(x: f64) -> i16

Available on crate features std or libm only.

fn conv_ceil(x: f64) -> i16

Available on crate features std or libm only.

fn try_conv_trunc(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f64) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f64> for i32

fn conv_trunc(x: f64) -> i32

Available on crate features std or libm only.

fn conv_nearest(x: f64) -> i32

Available on crate features std or libm only.

fn conv_floor(x: f64) -> i32

Available on crate features std or libm only.

fn conv_ceil(x: f64) -> i32

Available on crate features std or libm only.

fn try_conv_trunc(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f64) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f64> for i64

fn conv_trunc(x: f64) -> i64

Available on crate features std or libm only.

fn conv_nearest(x: f64) -> i64

Available on crate features std or libm only.

fn conv_floor(x: f64) -> i64

Available on crate features std or libm only.

fn conv_ceil(x: f64) -> i64

Available on crate features std or libm only.

fn try_conv_trunc(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f64) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f64> for i128

fn conv_trunc(x: f64) -> i128

Available on crate features std or libm only.

fn conv_nearest(x: f64) -> i128

Available on crate features std or libm only.

fn conv_floor(x: f64) -> i128

Available on crate features std or libm only.

fn conv_ceil(x: f64) -> i128

Available on crate features std or libm only.

fn try_conv_trunc(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f64) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f64> for isize

fn conv_trunc(x: f64) -> isize

Available on crate features std or libm only.

fn conv_nearest(x: f64) -> isize

Available on crate features std or libm only.

fn conv_floor(x: f64) -> isize

Available on crate features std or libm only.

fn conv_ceil(x: f64) -> isize

Available on crate features std or libm only.

fn try_conv_trunc(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f64) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f64> for u8

fn conv_trunc(x: f64) -> u8

Available on crate features std or libm only.

fn conv_nearest(x: f64) -> u8

Available on crate features std or libm only.

fn conv_floor(x: f64) -> u8

Available on crate features std or libm only.

fn conv_ceil(x: f64) -> u8

Available on crate features std or libm only.

fn try_conv_trunc(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f64) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f64> for u16

fn conv_trunc(x: f64) -> u16

Available on crate features std or libm only.

fn conv_nearest(x: f64) -> u16

Available on crate features std or libm only.

fn conv_floor(x: f64) -> u16

Available on crate features std or libm only.

fn conv_ceil(x: f64) -> u16

Available on crate features std or libm only.

fn try_conv_trunc(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f64) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f64> for u32

fn conv_trunc(x: f64) -> u32

Available on crate features std or libm only.

fn conv_nearest(x: f64) -> u32

Available on crate features std or libm only.

fn conv_floor(x: f64) -> u32

Available on crate features std or libm only.

fn conv_ceil(x: f64) -> u32

Available on crate features std or libm only.

fn try_conv_trunc(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f64) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f64> for u64

fn conv_trunc(x: f64) -> u64

Available on crate features std or libm only.

fn conv_nearest(x: f64) -> u64

Available on crate features std or libm only.

fn conv_floor(x: f64) -> u64

Available on crate features std or libm only.

fn conv_ceil(x: f64) -> u64

Available on crate features std or libm only.

fn try_conv_trunc(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f64) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f64> for u128

fn conv_trunc(x: f64) -> u128

Available on crate features std or libm only.

fn conv_nearest(x: f64) -> u128

Available on crate features std or libm only.

fn conv_floor(x: f64) -> u128

Available on crate features std or libm only.

fn conv_ceil(x: f64) -> u128

Available on crate features std or libm only.

fn try_conv_trunc(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f64) -> Result<Self>

Available on crate features std or libm only.

impl ConvFloat<f64> for usize

fn conv_trunc(x: f64) -> usize

Available on crate features std or libm only.

fn conv_nearest(x: f64) -> usize

Available on crate features std or libm only.

fn conv_floor(x: f64) -> usize

Available on crate features std or libm only.

fn conv_ceil(x: f64) -> usize

Available on crate features std or libm only.

fn try_conv_trunc(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_nearest(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_floor(x: f64) -> Result<Self>

Available on crate features std or libm only.

fn try_conv_ceil(x: f64) -> Result<Self>

Available on crate features std or libm only.

impl<S0, S1, T0: ConvFloat<S0>, T1: ConvFloat<S1>> ConvFloat<(S0, S1)> for (T0, T1)

fn try_conv_trunc(ss: (S0, S1)) -> Result<Self>

fn try_conv_nearest(ss: (S0, S1)) -> Result<Self>

fn try_conv_floor(ss: (S0, S1)) -> Result<Self>

fn try_conv_ceil(ss: (S0, S1)) -> Result<Self>

fn conv_trunc(ss: (S0, S1)) -> Self

fn conv_nearest(ss: (S0, S1)) -> Self

fn conv_floor(ss: (S0, S1)) -> Self

fn conv_ceil(ss: (S0, S1)) -> Self

impl<S, T: ConvFloat<S> + Copy + Default, const N: usize> ConvFloat<[S; N]> for [T; N]

fn try_conv_trunc(ss: [S; N]) -> Result<Self>

fn try_conv_nearest(ss: [S; N]) -> Result<Self>

fn try_conv_floor(ss: [S; N]) -> Result<Self>

fn try_conv_ceil(ss: [S; N]) -> Result<Self>

fn conv_trunc(ss: [S; N]) -> Self

fn conv_nearest(ss: [S; N]) -> Self

fn conv_floor(ss: [S; N]) -> Self

fn conv_ceil(ss: [S; N]) -> Self

Implementors