Struct SafeLong 

pub struct SafeLong(/* private fields */);

An i64 limited to a range safely representable in JSON.

JSON does not specify requirements of its numeric type, which can lead to issues interoperating between different JSON libraries and languages. In particular, some implementations (including Javascript) interpret numbers as double precision floating point values. Sufficiently large 64-bit integers are not exactly representable as doubles which can cause bugs as numbers change value as they’re transmitted from place to place.

The SafeLong type wraps an i64, and avoids these issues by limiting its value to the range that is exactly representable in a double: values between -2⁵³ + 1 and 2⁵³ - 1.

Implementations

impl SafeLong

pub fn min_value() -> SafeLong

Returns the smallest valid SafeLong.

pub fn max_value() -> SafeLong

Returns the largest valid SafeLong.

pub fn new(value: i64) -> Result<SafeLong, BoundsError>

Creates a new SafeLong from an i64.

Returns an error if the value is out of range.

Methods from Deref<Target = i64>

pub const MIN: i64

pub const MAX: i64

pub const BITS: u32 = u64::BITS

Trait Implementations

impl Clone for SafeLong

fn clone(&self) -> SafeLong

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SafeLong

impl Debug for SafeLong

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

Formats the value using the given formatter.

impl Default for SafeLong

fn default() -> SafeLong

Returns the “default value” for a type.

impl Deref for SafeLong

type Target = i64

The resulting type after dereferencing.

fn deref(&self) -> &i64

Dereferences the value.

impl<'de> Deserialize<'de> for SafeLong

fn deserialize<D>(d: D) -> Result<SafeLong, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SafeLong

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

Formats the value using the given formatter.

impl Eq for SafeLong

impl From<SafeLong> for i64

fn from(n: SafeLong) -> i64

Converts to this type from the input type.

impl From<SafeLong> for i128

fn from(n: SafeLong) -> i128

Converts to this type from the input type.

impl From<i8> for SafeLong

fn from(n: i8) -> SafeLong

Converts to this type from the input type.

impl From<i16> for SafeLong

fn from(n: i16) -> SafeLong

Converts to this type from the input type.

impl From<i32> for SafeLong

fn from(n: i32) -> SafeLong

Converts to this type from the input type.

impl From<u8> for SafeLong

fn from(n: u8) -> SafeLong

Converts to this type from the input type.

impl From<u16> for SafeLong

fn from(n: u16) -> SafeLong

Converts to this type from the input type.

impl From<u32> for SafeLong

fn from(n: u32) -> SafeLong

Converts to this type from the input type.

impl FromPlain for SafeLong

type Err = <SafeLong as FromStr>::Err

The error type returned when parsing fails.

fn from_plain(s: &str) -> Result<Self, Self::Err>

Parse a value from its Conjure PLAIN string representation.

impl FromStr for SafeLong

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<SafeLong, ParseError>

Parses a string s to return a value of this type.

impl Hash for SafeLong

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for SafeLong

fn cmp(&self, other: &SafeLong) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for SafeLong

fn eq(&self, other: &SafeLong) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for SafeLong

fn partial_cmp(&self, other: &SafeLong) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Plain for SafeLong

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

Formats this value in its Conjure PLAIN format.

impl Serialize for SafeLong

fn serialize<S>(&self, s: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SafeLong

impl TryFrom<SafeLong> for u8

type Error = TryFromIntError

The type returned in the event of a conversion error.

fn try_from(n: SafeLong) -> Result<u8, TryFromIntError>

Performs the conversion.

impl TryFrom<SafeLong> for i8

type Error = TryFromIntError

The type returned in the event of a conversion error.

fn try_from(n: SafeLong) -> Result<i8, TryFromIntError>

Performs the conversion.

impl TryFrom<SafeLong> for u16

type Error = TryFromIntError

The type returned in the event of a conversion error.

fn try_from(n: SafeLong) -> Result<u16, TryFromIntError>

Performs the conversion.

impl TryFrom<SafeLong> for i16

type Error = TryFromIntError

The type returned in the event of a conversion error.

fn try_from(n: SafeLong) -> Result<i16, TryFromIntError>

Performs the conversion.

impl TryFrom<SafeLong> for u32

type Error = TryFromIntError

The type returned in the event of a conversion error.

fn try_from(n: SafeLong) -> Result<u32, TryFromIntError>

Performs the conversion.

impl TryFrom<SafeLong> for i32

type Error = TryFromIntError

The type returned in the event of a conversion error.

fn try_from(n: SafeLong) -> Result<i32, TryFromIntError>

Performs the conversion.

impl TryFrom<SafeLong> for u64

type Error = TryFromIntError

The type returned in the event of a conversion error.

fn try_from(n: SafeLong) -> Result<u64, TryFromIntError>

Performs the conversion.

impl TryFrom<SafeLong> for u128

type Error = TryFromIntError

The type returned in the event of a conversion error.

fn try_from(n: SafeLong) -> Result<u128, TryFromIntError>

Performs the conversion.

impl TryFrom<SafeLong> for usize

type Error = TryFromIntError

The type returned in the event of a conversion error.

fn try_from(n: SafeLong) -> Result<usize, TryFromIntError>

Performs the conversion.

impl TryFrom<SafeLong> for isize

type Error = TryFromIntError

The type returned in the event of a conversion error.

fn try_from(n: SafeLong) -> Result<isize, TryFromIntError>

Performs the conversion.

impl TryFrom<i64> for SafeLong

type Error = BoundsError

The type returned in the event of a conversion error.

fn try_from(n: i64) -> Result<SafeLong, BoundsError>

Performs the conversion.

impl TryFrom<i128> for SafeLong

type Error = BoundsError

The type returned in the event of a conversion error.

fn try_from(n: i128) -> Result<SafeLong, BoundsError>

Performs the conversion.

impl TryFrom<isize> for SafeLong

type Error = BoundsError

The type returned in the event of a conversion error.

fn try_from(n: isize) -> Result<SafeLong, BoundsError>

Performs the conversion.

impl TryFrom<u64> for SafeLong

type Error = BoundsError

The type returned in the event of a conversion error.

fn try_from(n: u64) -> Result<SafeLong, BoundsError>

Performs the conversion.

impl TryFrom<u128> for SafeLong

type Error = BoundsError

The type returned in the event of a conversion error.

fn try_from(n: u128) -> Result<SafeLong, BoundsError>

Performs the conversion.

impl TryFrom<usize> for SafeLong

type Error = BoundsError

The type returned in the event of a conversion error.

fn try_from(n: usize) -> Result<SafeLong, BoundsError>

Performs the conversion.