pub struct Int64(/* private fields */);
Expand description
An implementation of i64 that is using strings for JSON encoding/decoding, such that the full i64 range can be used for clients that convert JSON numbers to floats, like JavaScript and jq.
§Examples
Use from
to create instances of this and i64
to get the value out:
let a = Int64::from(258i64);
assert_eq!(a.i64(), 258);
Implementations§
Source§impl Int64
impl Int64
pub const MAX: Int64
pub const MIN: Int64
Sourcepub const fn new(value: i64) -> Self
pub const fn new(value: i64) -> Self
Creates a Int64(value).
This method is less flexible than from
but can be called in a const context.
Sourcepub const fn from_be_bytes(data: [u8; 8]) -> Self
pub const fn from_be_bytes(data: [u8; 8]) -> Self
Constructs new value from big endian bytes
Sourcepub const fn from_le_bytes(data: [u8; 8]) -> Self
pub const fn from_le_bytes(data: [u8; 8]) -> Self
Constructs new value from little endian bytes
Sourcepub const fn to_be_bytes(self) -> [u8; 8]
pub const fn to_be_bytes(self) -> [u8; 8]
Returns a copy of the number as big endian bytes.
Sourcepub const fn to_le_bytes(self) -> [u8; 8]
pub const fn to_le_bytes(self) -> [u8; 8]
Returns a copy of the number as little endian bytes.
pub const fn is_zero(&self) -> bool
pub const fn is_negative(&self) -> bool
pub const fn pow(self, exp: u32) -> Self
Sourcepub fn checked_multiply_ratio<A: Into<Self>, B: Into<Self>>(
&self,
numerator: A,
denominator: B,
) -> Result<Self, CheckedMultiplyRatioError>
pub fn checked_multiply_ratio<A: Into<Self>, B: Into<Self>>( &self, numerator: A, denominator: B, ) -> Result<Self, CheckedMultiplyRatioError>
Returns self * numerator / denominator
.
Due to the nature of the integer division involved, the result is always floored. E.g. 5 * 99/100 = 4.
pub fn checked_add(self, other: Self) -> Result<Self, OverflowError>
pub fn checked_sub(self, other: Self) -> Result<Self, OverflowError>
pub fn checked_mul(self, other: Self) -> Result<Self, OverflowError>
pub fn checked_pow(self, exp: u32) -> Result<Self, OverflowError>
pub fn checked_div(self, other: Self) -> Result<Self, DivisionError>
pub fn checked_div_euclid(self, other: Self) -> Result<Self, DivisionError>
pub fn checked_rem(self, other: Self) -> Result<Self, DivideByZeroError>
pub fn checked_shr(self, other: u32) -> Result<Self, OverflowError>
pub fn checked_shl(self, other: u32) -> Result<Self, OverflowError>
pub fn wrapping_add(self, other: Self) -> Self
pub fn wrapping_sub(self, other: Self) -> Self
pub fn wrapping_mul(self, other: Self) -> Self
pub fn wrapping_pow(self, other: u32) -> Self
pub fn saturating_add(self, other: Self) -> Self
pub fn saturating_sub(self, other: Self) -> Self
pub fn saturating_mul(self, other: Self) -> Self
pub fn saturating_pow(self, exp: u32) -> Self
pub const fn abs_diff(self, other: Self) -> Uint64
pub const fn abs(self) -> Self
pub const fn unsigned_abs(self) -> Uint64
Sourcepub const fn strict_neg(self) -> Self
pub const fn strict_neg(self) -> Self
Strict negation. Computes -self, panicking if self == MIN.
This is the same as Int64::neg
but const.
Trait Implementations§
Source§impl AddAssign<&Int64> for Int64
impl AddAssign<&Int64> for Int64
Source§fn add_assign(&mut self, other: &Int64)
fn add_assign(&mut self, other: &Int64)
+=
operation. Read moreSource§impl AddAssign for Int64
impl AddAssign for Int64
Source§fn add_assign(&mut self, rhs: Int64)
fn add_assign(&mut self, rhs: Int64)
+=
operation. Read moreSource§impl<'de> Deserialize<'de> for Int64
impl<'de> Deserialize<'de> for Int64
Source§fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>where
D: Deserializer<'de>,
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>where
D: Deserializer<'de>,
Deserializes from an integer string using base 10.
See the Serialize
documentation for a few more words
on the encoding of the UintXXX
/IntYYY
family.
Source§impl DivAssign<&Int64> for Int64
impl DivAssign<&Int64> for Int64
Source§fn div_assign(&mut self, other: &Int64)
fn div_assign(&mut self, other: &Int64)
/=
operation. Read moreSource§impl DivAssign for Int64
impl DivAssign for Int64
Source§fn div_assign(&mut self, rhs: Self)
fn div_assign(&mut self, rhs: Self)
/=
operation. Read moreSource§impl JsonSchema for Int64
impl JsonSchema for Int64
Source§fn schema_name() -> String
fn schema_name() -> String
Source§fn schema_id() -> Cow<'static, str>
fn schema_id() -> Cow<'static, str>
Source§fn json_schema(generator: &mut SchemaGenerator) -> Schema
fn json_schema(generator: &mut SchemaGenerator) -> Schema
Source§fn is_referenceable() -> bool
fn is_referenceable() -> bool
$ref
keyword. Read moreSource§impl MulAssign<&Int64> for Int64
impl MulAssign<&Int64> for Int64
Source§fn mul_assign(&mut self, other: &Int64)
fn mul_assign(&mut self, other: &Int64)
*=
operation. Read moreSource§impl MulAssign for Int64
impl MulAssign for Int64
Source§fn mul_assign(&mut self, rhs: Self)
fn mul_assign(&mut self, rhs: Self)
*=
operation. Read moreSource§impl Ord for Int64
impl Ord for Int64
Source§impl PartialOrd for Int64
impl PartialOrd for Int64
Source§impl RemAssign<&Int64> for Int64
impl RemAssign<&Int64> for Int64
Source§fn rem_assign(&mut self, other: &Int64)
fn rem_assign(&mut self, other: &Int64)
%=
operation. Read moreSource§impl RemAssign for Int64
impl RemAssign for Int64
Source§fn rem_assign(&mut self, rhs: Int64)
fn rem_assign(&mut self, rhs: Int64)
%=
operation. Read moreSource§impl Serialize for Int64
impl Serialize for Int64
Source§fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>where
S: Serializer,
fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>where
S: Serializer,
Serializes as an integer string using base 10.
We consistently serialize all UintXXX
and IntYYY
types as strings in JSON
to ensure the best possible compatibility with clients. E.g. JavaScript and jq
only support up to ~53bit numbers without losing precision, making it hard to use
serialized u64
s on other systems than Rust or Go. Uint64
/Int64
ensure the full
64 bit range is supported. For larger integers, the use of strings is pretty much the
only reasonable way to store them in JSON.
For binary encodings (notably MessagePack) strings are used too. The reason is that
in MessagePack integers are limited to 64 bit and we strive for consistent encoding
within the UintXXX
/IntYYY
family. Also for small to mid sized values, decimal strings
are often more compact than a fixed-length binary encoding.
§Examples
Serialize to JSON:
let value = Uint64::new(17);
let serialized = to_json_vec(&value).unwrap();
assert_eq!(serialized, b"\"17\"");
Serialize to MessagePack:
let value = Uint64::new(17);
let serialized = to_msgpack_vec(&value).unwrap();
assert_eq!(serialized, [0b10100000 ^ 2, b'1', b'7']); // string of lengths 2 with value "17"
Source§impl ShlAssign<&u32> for Int64
impl ShlAssign<&u32> for Int64
Source§fn shl_assign(&mut self, other: &u32)
fn shl_assign(&mut self, other: &u32)
<<=
operation. Read moreSource§impl ShlAssign<u32> for Int64
impl ShlAssign<u32> for Int64
Source§fn shl_assign(&mut self, rhs: u32)
fn shl_assign(&mut self, rhs: u32)
<<=
operation. Read moreSource§impl ShrAssign<&u32> for Int64
impl ShrAssign<&u32> for Int64
Source§fn shr_assign(&mut self, other: &u32)
fn shr_assign(&mut self, other: &u32)
>>=
operation. Read moreSource§impl ShrAssign<u32> for Int64
impl ShrAssign<u32> for Int64
Source§fn shr_assign(&mut self, rhs: u32)
fn shr_assign(&mut self, rhs: u32)
>>=
operation. Read moreSource§impl SubAssign<&Int64> for Int64
impl SubAssign<&Int64> for Int64
Source§fn sub_assign(&mut self, other: &Int64)
fn sub_assign(&mut self, other: &Int64)
-=
operation. Read moreSource§impl SubAssign for Int64
impl SubAssign for Int64
Source§fn sub_assign(&mut self, rhs: Int64)
fn sub_assign(&mut self, rhs: Int64)
-=
operation. Read moreimpl Copy for Int64
impl Eq for Int64
impl StructuralPartialEq for Int64
Auto Trait Implementations§
impl Freeze for Int64
impl RefUnwindSafe for Int64
impl Send for Int64
impl Sync for Int64
impl Unpin for Int64
impl UnwindSafe for Int64
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more