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 { ... }
}

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

fn conv_nearest(x: f32) -> i8

fn conv_floor(x: f32) -> i8

fn conv_ceil(x: f32) -> i8

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 i16

fn conv_trunc(x: f32) -> i16

fn conv_nearest(x: f32) -> i16

fn conv_floor(x: f32) -> i16

fn conv_ceil(x: f32) -> i16

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 i32

fn conv_trunc(x: f32) -> i32

fn conv_nearest(x: f32) -> i32

fn conv_floor(x: f32) -> i32

fn conv_ceil(x: f32) -> i32

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 i64

fn conv_trunc(x: f32) -> i64

fn conv_nearest(x: f32) -> i64

fn conv_floor(x: f32) -> i64

fn conv_ceil(x: f32) -> i64

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 i128

fn conv_trunc(x: f32) -> i128

fn conv_nearest(x: f32) -> i128

fn conv_floor(x: f32) -> i128

fn conv_ceil(x: f32) -> i128

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 isize

fn conv_trunc(x: f32) -> isize

fn conv_nearest(x: f32) -> isize

fn conv_floor(x: f32) -> isize

fn conv_ceil(x: f32) -> isize

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 u8

fn conv_trunc(x: f32) -> u8

fn conv_nearest(x: f32) -> u8

fn conv_floor(x: f32) -> u8

fn conv_ceil(x: f32) -> u8

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 u16

fn conv_trunc(x: f32) -> u16

fn conv_nearest(x: f32) -> u16

fn conv_floor(x: f32) -> u16

fn conv_ceil(x: f32) -> u16

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 u32

fn conv_trunc(x: f32) -> u32

fn conv_nearest(x: f32) -> u32

fn conv_floor(x: f32) -> u32

fn conv_ceil(x: f32) -> u32

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 u64

fn conv_trunc(x: f32) -> u64

fn conv_nearest(x: f32) -> u64

fn conv_floor(x: f32) -> u64

fn conv_ceil(x: f32) -> u64

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 u128

Available on crate features std or libm only.

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

fn conv_nearest(x: f32) -> usize

fn conv_floor(x: f32) -> usize

fn conv_ceil(x: f32) -> usize

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<f64> for i8

fn conv_trunc(x: f64) -> i8

fn conv_nearest(x: f64) -> i8

fn conv_floor(x: f64) -> i8

fn conv_ceil(x: f64) -> i8

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

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

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

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

impl ConvFloat<f64> for i16

fn conv_trunc(x: f64) -> i16

fn conv_nearest(x: f64) -> i16

fn conv_floor(x: f64) -> i16

fn conv_ceil(x: f64) -> i16

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

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

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

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

impl ConvFloat<f64> for i32

fn conv_trunc(x: f64) -> i32

fn conv_nearest(x: f64) -> i32

fn conv_floor(x: f64) -> i32

fn conv_ceil(x: f64) -> i32

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

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

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

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

impl ConvFloat<f64> for i64

fn conv_trunc(x: f64) -> i64

fn conv_nearest(x: f64) -> i64

fn conv_floor(x: f64) -> i64

fn conv_ceil(x: f64) -> i64

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

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

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

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

impl ConvFloat<f64> for i128

fn conv_trunc(x: f64) -> i128

fn conv_nearest(x: f64) -> i128

fn conv_floor(x: f64) -> i128

fn conv_ceil(x: f64) -> i128

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

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

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

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

impl ConvFloat<f64> for isize

fn conv_trunc(x: f64) -> isize

fn conv_nearest(x: f64) -> isize

fn conv_floor(x: f64) -> isize

fn conv_ceil(x: f64) -> isize

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

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

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

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

impl ConvFloat<f64> for u8

fn conv_trunc(x: f64) -> u8

fn conv_nearest(x: f64) -> u8

fn conv_floor(x: f64) -> u8

fn conv_ceil(x: f64) -> u8

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

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

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

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

impl ConvFloat<f64> for u16

fn conv_trunc(x: f64) -> u16

fn conv_nearest(x: f64) -> u16

fn conv_floor(x: f64) -> u16

fn conv_ceil(x: f64) -> u16

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

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

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

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

impl ConvFloat<f64> for u32

fn conv_trunc(x: f64) -> u32

fn conv_nearest(x: f64) -> u32

fn conv_floor(x: f64) -> u32

fn conv_ceil(x: f64) -> u32

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

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

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

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

impl ConvFloat<f64> for u64

fn conv_trunc(x: f64) -> u64

fn conv_nearest(x: f64) -> u64

fn conv_floor(x: f64) -> u64

fn conv_ceil(x: f64) -> u64

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

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

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

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

impl ConvFloat<f64> for u128

fn conv_trunc(x: f64) -> u128

fn conv_nearest(x: f64) -> u128

fn conv_floor(x: f64) -> u128

fn conv_ceil(x: f64) -> u128

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

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

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

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

impl ConvFloat<f64> for usize

fn conv_trunc(x: f64) -> usize

fn conv_nearest(x: f64) -> usize

fn conv_floor(x: f64) -> usize

fn conv_ceil(x: f64) -> usize

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

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

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

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

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

Available on crate features std or libm only.

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]

Available on crate features std or libm only.

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