Struct conjure_object::SafeLong

pub struct SafeLong(_);

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.

Methods

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.

Trait Implementations

impl Plain for SafeLong

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

Formats this value in its Conjure PLAIN format.

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 From<u8> for SafeLong

fn from(n: u8) -> SafeLong

Performs the conversion.

impl From<i8> for SafeLong

fn from(n: i8) -> SafeLong

Performs the conversion.

impl From<u16> for SafeLong

fn from(n: u16) -> SafeLong

Performs the conversion.

impl From<i16> for SafeLong

fn from(n: i16) -> SafeLong

Performs the conversion.

impl From<u32> for SafeLong

fn from(n: u32) -> SafeLong

Performs the conversion.

impl From<i32> for SafeLong

fn from(n: i32) -> SafeLong

Performs the conversion.

impl From<SafeLong> for i64

fn from(n: SafeLong) -> i64

Performs the conversion.

impl From<SafeLong> for i128

fn from(n: SafeLong) -> i128

Performs the conversion.

impl Clone for SafeLong

fn clone(&self) -> SafeLong

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for SafeLong

impl Default for SafeLong

fn default() -> SafeLong

Returns the "default value" for a type.

impl Eq for SafeLong

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<SafeLong> for SafeLong

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<SafeLong> 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: &SafeLong) -> bool

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl Display for SafeLong

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

Formats the value using the given formatter.

impl Debug for SafeLong

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

Formats the value using the given formatter.

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

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<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 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 Deref for SafeLong

type Target = i64

The resulting type after dereferencing.

fn deref(&self) -> &i64

Dereferences the value.

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, 

Feeds a slice of this type into the given [Hasher].

impl StructuralPartialEq for SafeLong

impl StructuralEq for SafeLong

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<'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.