Trait Fixable

pub trait Fixable: Sealed + Sized {
    // Required method
    fn to_fix(self) -> Option<i64>;

    // Provided method
    fn is_fixable(self) -> bool { ... }
}

Marker trait for numeric values which can be converted to a “fixnum”, or Integer, representation.

A numeric value is fixable if its integral portion can fit within 63 bits of an i64.

See RUBY_FIXNUM_MIN and RUBY_FIXNUM_MAX for more details on the range of values yielded by implementers of this trait.

This trait is sealed and cannot be implemented outside of this crate.

Required Methods

fn to_fix(self) -> Option<i64>

Convert a fixable numeric value to its integral part.

This method returns None if self is out of range.

Provided Methods

fn is_fixable(self) -> bool

Test whether a fixable numeric value is in range.

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 Fixable for f32

fn to_fix(self) -> Option<i64>

Convert an f32 to a fixnum if it is less than or equal to RUBY_FIXNUM_MAX and greater than or equal to RUBY_FIXNUM_MIN in magnitude.

This method returns None if the receiver is greater than RUBY_FIXNUM_MAX or less than RUBY_FIXNUM_MIN.

This function discards the fractional part of the float, i.e. truncates.

NaN and infinities return None.

Implementation Notes

Conversion is implemented using checked operations and will never panic.

This conversion is implemented using Duration::try_from_secs_f32 and extracting the the integral portion of the float via Duration::as_secs.

impl Fixable for f64

fn to_fix(self) -> Option<i64>

Convert an f64 to a fixnum if it is less than or equal to RUBY_FIXNUM_MAX and greater than or equal to RUBY_FIXNUM_MIN in magnitude.

This method returns None if the receiver is greater than RUBY_FIXNUM_MAX or less than RUBY_FIXNUM_MIN.

This function discards the fractional part of the float, i.e. truncates.

NaN and infinities return None.

Implementation Notes

Conversion is implemented using checked operations and will never panic.

This conversion is implemented using Duration::try_from_secs_f64 and extracting the the integral portion of the float via Duration::as_secs.

impl Fixable for i8

fn to_fix(self) -> Option<i64>

Convert an i8 to a fixnum.

This method on i8 is infallible and will always return Some(self) since i8 is always in range of fixnum.

fn is_fixable(self) -> bool

Test whether an i8 value is in range of fixnum.

This method on i8 will always return true since i8 is always in range of fixnum.

impl Fixable for i16

fn to_fix(self) -> Option<i64>

Convert an i16 to a fixnum.

This method on i16 is infallible and will always return Some(self) since i16 is always in range of fixnum.

fn is_fixable(self) -> bool

Test whether an i16 value is in range of fixnum.

This method on i16 will always return true since i16 is always in range of fixnum.

impl Fixable for i32

fn to_fix(self) -> Option<i64>

Convert an i32 to a fixnum.

This method on i32 is infallible and will always return Some(self) since i32 is always in range of fixnum.

fn is_fixable(self) -> bool

Test whether an i32 value is in range of fixnum.

This method on i32 will always return true since i32 is always in range of fixnum.

impl Fixable for i64

fn to_fix(self) -> Option<i64>

Convert an i64 to a fixnum if it is less than or equal to RUBY_FIXNUM_MAX and greater than or equal to RUBY_FIXNUM_MIN in magnitude.

This method returns None if the receiver is greater than RUBY_FIXNUM_MAX or less than RUBY_FIXNUM_MIN.

fn is_fixable(self) -> bool

Test whether an i64 value is in range of fixnum.

This method returns false if the receiver is greater than RUBY_FIXNUM_MAX or less than RUBY_FIXNUM_MAX.

impl Fixable for i128

fn to_fix(self) -> Option<i64>

Convert an i128 to a fixnum if it is less than or equal to RUBY_FIXNUM_MAX and greater than or equal to RUBY_FIXNUM_MIN in magnitude.

This method returns None if the receiver is greater than RUBY_FIXNUM_MAX or less than RUBY_FIXNUM_MIN.

fn is_fixable(self) -> bool

Test whether an i128 value is in range of fixnum.

This method returns false if the receiver is greater than RUBY_FIXNUM_MAX or less than RUBY_FIXNUM_MAX.

impl Fixable for u8

fn to_fix(self) -> Option<i64>

Convert a u8 to a fixnum.

This method on u8 is infallible and will always return Some(self) since u8 is always in range of fixnum.

fn is_fixable(self) -> bool

Test whether a u8 value is in range of fixnum.

This method on u8 will always return true since u8 is always in range of fixnum.

impl Fixable for u16

fn to_fix(self) -> Option<i64>

Convert a u16 to a fixnum.

This method on u16 is infallible and will always return Some(self) since u16 is always in range of fixnum.

fn is_fixable(self) -> bool

Test whether a u16 value is in range of fixnum.

This method on u16 will always return true since u16 is always in range of fixnum.

impl Fixable for u32

fn to_fix(self) -> Option<i64>

Convert a u32 to a fixnum.

This method on u32 is infallible and will always return Some(self) since u32 is always in range of fixnum.

fn is_fixable(self) -> bool

Test whether a u32 value is in range of fixnum.

This method on u32 will always return true since u32 is always in range of fixnum.

impl Fixable for u64

fn to_fix(self) -> Option<i64>

Convert a u64 to a fixnum if it is less than or equal to RUBY_FIXNUM_MAX in magnitude.

This method returns None if the receiver is greater than RUBY_FIXNUM_MAX.

fn is_fixable(self) -> bool

Test whether a u64 value is in range of fixnum.

This method returns false if the receiver is greater than RUBY_FIXNUM_MAX.

impl Fixable for u128

fn to_fix(self) -> Option<i64>

Convert a u128 to a fixnum if it is less than or equal to RUBY_FIXNUM_MAX in magnitude.

This method returns None if the receiver is greater than RUBY_FIXNUM_MAX.

fn is_fixable(self) -> bool

Test whether a u128 value is in range of fixnum.

This method returns false if the receiver is greater than RUBY_FIXNUM_MAX.

Implementors