Struct Nearest 

pub struct Nearest;

Available on crate features libm or std only.

Round to the nearest representable value

The precise behaviour of half-way cases is implementation-defined. Provided implementations follow common practices: float-to-int conversions use the round() inherent function which rounds away from zero while int-to-float conversions follow the behaviour of as numeric casts which rounds ties to even.

Example: 2.5_f32 converts to 3_i32, -2.5_f32 converts to -3_i32. Another example: converting i32::MAX to f32 rounds up to 2³¹.

The § Limits of approximation as specified by Approx apply.

Trait Implementations

impl Clone for Nearest

fn clone(&self) -> Nearest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<S, T: ConvExact<S>> ConvTo<S, Nearest> for T

type Error = <T as ConvExact<S>>::Error

Conversion error type

fn try_conv_to(_: Nearest, s: S) -> Result<Self, Self::Error>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, s: S) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f32, Nearest> for i8

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f32) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f32) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f32, Nearest> for i16

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f32) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f32) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f32, Nearest> for i32

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f32) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f32) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f32, Nearest> for i64

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f32) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f32) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f32, Nearest> for i128

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f32) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f32) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f32, Nearest> for isize

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f32) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f32) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f32, Nearest> for u8

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f32) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f32) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f32, Nearest> for u16

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f32) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f32) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f32, Nearest> for u32

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f32) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f32) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f32, Nearest> for u64

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f32) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f32) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f32, Nearest> for usize

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f32) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f32) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f32, Nearest> for u128

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f32) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f32) -> u128

Convert from S to Self, rounding according to mode

impl ConvTo<f64, Nearest> for i8

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f64) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f64) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f64, Nearest> for i16

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f64) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f64) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f64, Nearest> for i32

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f64) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f64) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f64, Nearest> for i64

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f64) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f64) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f64, Nearest> for i128

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f64) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f64) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f64, Nearest> for isize

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f64) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f64) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f64, Nearest> for u8

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f64) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f64) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f64, Nearest> for u16

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f64) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f64) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f64, Nearest> for u32

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f64) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f64) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f64, Nearest> for u64

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f64) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f64) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f64, Nearest> for u128

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f64) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f64) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<f64, Nearest> for usize

type Error = RangeError

Conversion error type

fn try_conv_to(_: Nearest, x: f64) -> Result<Self, RangeError>

Try converting from S to Self, rounding according to mode

fn conv_to(_: Nearest, x: f64) -> Self

Convert from S to Self, rounding according to mode

impl ConvTo<i32, Nearest> for f32

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: i32) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: i32) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<i64, Nearest> for f32

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: i64) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: i64) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<i64, Nearest> for f64

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: i64) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: i64) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<i128, Nearest> for f32

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: i128) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: i128) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<i128, Nearest> for f64

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: i128) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: i128) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<isize, Nearest> for f32

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: isize) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: isize) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<isize, Nearest> for f64

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: isize) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: isize) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<u32, Nearest> for f32

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: u32) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: u32) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<u64, Nearest> for f32

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: u64) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: u64) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<u64, Nearest> for f64

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: u64) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: u64) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<u128, Nearest> for f32

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: u128) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: u128) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<u128, Nearest> for f64

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: u128) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: u128) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<usize, Nearest> for f32

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: usize) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: usize) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl ConvTo<usize, Nearest> for f64

type Error = Infallible

Conversion error type

fn conv_to(_: Nearest, x: usize) -> Self

Convert from S to Self, rounding according to mode

fn try_conv_to(_: Nearest, x: usize) -> Result<Self, Infallible>

Try converting from S to Self, rounding according to mode

impl Copy for Nearest

impl Debug for Nearest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Nearest

fn default() -> Nearest

Returns the “default value” for a type.

impl Rounding for Nearest

type MaximumError = RangeError

Maximum error type