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

fn default() -> SafeLong

Returns the "default value" for a type.

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

impl Eq for SafeLong

impl Copy for SafeLong

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

type Target = i64

The resulting type after dereferencing.

fn deref(&self) -> &i64

Dereferences the value.

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.