Struct Integer

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

A dynamically sized integer type. This type is similar to num_bigint::BigInt in that it allows for integers of arbitary size making it ideal for handling ASN.1 INTEGER types, in addition this type includes small integer optimisations accounting for the fact integers decoded in ASN.1 don’t exceed native platform widths.

Implementations

impl Integer

pub const ZERO: Self

Represents 0.

pub const ONE: Self

Represents 1.

Trait Implementations

impl Add<i128> for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: i128) -> Self::Output

Performs the + operation.

impl Add<i16> for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: i16) -> Self::Output

Performs the + operation.

impl Add<i32> for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: i32) -> Self::Output

Performs the + operation.

impl Add<i64> for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: i64) -> Self::Output

Performs the + operation.

impl Add<i8> for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: i8) -> Self::Output

Performs the + operation.

impl Add<isize> for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: isize) -> Self::Output

Performs the + operation.

impl Add<u128> for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: u128) -> Self::Output

Performs the + operation.

impl Add<u16> for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: u16) -> Self::Output

Performs the + operation.

impl Add<u32> for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: u32) -> Self::Output

Performs the + operation.

impl Add<u64> for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: u64) -> Self::Output

Performs the + operation.

impl Add<u8> for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: u8) -> Self::Output

Performs the + operation.

impl Add<usize> for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: usize) -> Self::Output

Performs the + operation.

impl Add for Integer

type Output = Integer

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl AsnType for Integer

const TAG: Tag = Tag::INTEGER

The associated tag for the type.

const IDENTIFIER: Identifier = Identifier::INTEGER

Identifier of an ASN.1 type as specified in the original specification if not identical with the identifier of Self

const TAG_TREE: TagTree = _

The root of this type’s tree of tag’s if it a CHOICE type, otherwise its Leaf that points Self::TAG.

const CONSTRAINTS: Constraints = Constraints::NONE

The set of constraints for values of the given type.

fn is_present(&self) -> bool

Whether the type is present with value. OPTIONAL fields are common in SEQUENCE or SET.

impl CheckedAdd for Integer

fn checked_add(&self, other: &Self) -> Option<Self>

Adds two numbers, checking for overflow. If overflow happens, None is returned.

impl CheckedSub for Integer

fn checked_sub(&self, other: &Self) -> Option<Self>

Subtracts two numbers, checking for underflow. If underflow happens, None is returned.

impl Clone for Integer

fn clone(&self) -> Integer

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Integer

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

Formats the value using the given formatter.

impl Decode for Integer

fn decode_with_tag_and_constraints<D: Decoder>( decoder: &mut D, tag: Tag, constraints: Constraints, ) -> Result<Self, D::Error>

Decode this value implicitly tagged with tag from a given ASN.1 decoder with a set of constraints on what values of that type are allowed.

fn decode<D: Decoder>(decoder: &mut D) -> Result<Self, D::Error>

Decode this value from a given ASN.1 decoder.

fn decode_with_tag<D: Decoder>( decoder: &mut D, tag: Tag, ) -> Result<Self, D::Error>

Decode this value implicitly tagged with tag from a given ASN.1 decoder.

fn decode_with_constraints<D: Decoder>( decoder: &mut D, constraints: Constraints, ) -> Result<Self, D::Error>

Decode this value from a given ASN.1 decoder with a set of constraints on what values of that type are allowed.

impl Default for Integer

fn default() -> Self

Returns the “default value” for a type.

impl Display for Integer

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

Formats the value using the given formatter.

impl Encode for Integer

fn encode_with_tag_and_constraints<'b, E: Encoder<'b>>( &self, encoder: &mut E, tag: Tag, constraints: Constraints, identifier: Identifier, ) -> Result<(), E::Error>

Encode this value with tag into the given crate::Encoder with the constraints the values this is allowed to encode into.

fn encode<'b, E: Encoder<'b>>(&self, encoder: &mut E) -> Result<(), E::Error>

Encodes self’s data into the given crate::Encoder.

fn encode_with_tag<'b, E: Encoder<'b>>( &self, encoder: &mut E, tag: Tag, ) -> Result<(), E::Error>

Encode this value with tag into the given crate::Encoder.

fn encode_with_identifier<'b, E: Encoder<'b>>( &self, encoder: &mut E, identifier: Identifier, ) -> Result<(), E::Error>

Encode this value with identifier into the given crate::Encoder.

fn encode_with_tag_and_identifier<'b, E: Encoder<'b>>( &self, encoder: &mut E, tag: Tag, identifier: Identifier, ) -> Result<(), E::Error>

Encode this value with tag and identifier into the given crate::Encoder.

fn encode_with_constraints<'b, E: Encoder<'b>>( &self, encoder: &mut E, constraints: Constraints, ) -> Result<(), E::Error>

Encode this value into the given crate::Encoder with the constraints the values this is allowed to encode into.

fn encode_with_constraints_and_identifier<'b, E: Encoder<'b>>( &self, encoder: &mut E, constraints: Constraints, identifier: Identifier, ) -> Result<(), E::Error>

Encode this value into the given crate::Encoder with identifier and the constraints the values this is allowed to encode into.

impl From<BigInt> for Integer

fn from(value: BigInt) -> Self

Converts to this type from the input type.

impl From<Integer> for BigInt

fn from(value: Integer) -> Self

Converts to this type from the input type.

impl From<i128> for Integer

fn from(value: i128) -> Self

Converts to this type from the input type.

impl From<i16> for Integer

fn from(value: i16) -> Self

Converts to this type from the input type.

impl From<i32> for Integer

fn from(value: i32) -> Self

Converts to this type from the input type.

impl From<i64> for Integer

fn from(value: i64) -> Self

Converts to this type from the input type.

impl From<i8> for Integer

fn from(value: i8) -> Self

Converts to this type from the input type.

impl From<isize> for Integer

fn from(value: isize) -> Self

Converts to this type from the input type.

impl From<u128> for Integer

fn from(value: u128) -> Self

Converts to this type from the input type.

impl From<u16> for Integer

fn from(value: u16) -> Self

Converts to this type from the input type.

impl From<u32> for Integer

fn from(value: u32) -> Self

Converts to this type from the input type.

impl From<u64> for Integer

fn from(value: u64) -> Self

Converts to this type from the input type.

impl From<u8> for Integer

fn from(value: u8) -> Self

Converts to this type from the input type.

impl From<usize> for Integer

fn from(value: usize) -> Self

Converts to this type from the input type.

impl Hash for Integer

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 IntegerType for Integer

const WIDTH: u32 = 4_294_967_295u32

The bit level width of the integer (e.g. u32 is 32 bits).

const ZERO: Integer = Integer::ZERO

Represents 0 in a given integer.

type UnsignedPair = Integer

Self as an unsigned type with the same width.

type SignedPair = Integer

Self as a signed type with one type size larger to prevent truncation, in case Self is unsigned. (e.g. u8 -> i16) Truncation would happen if unsigned type is converted to signed bytes with the same size.

fn try_from_bytes(input: &[u8], codec: Codec) -> Result<Self, DecodeError>

Attempts to convert the input data matching the given codec into Self.

fn try_from_signed_bytes( input: &[u8], codec: Codec, ) -> Result<Self, DecodeError>

Attempts to convert the input data (assuming signed bytes) matching the given codec into Self.

fn try_from_unsigned_bytes( input: &[u8], codec: Codec, ) -> Result<Self, DecodeError>

Attempts to convert the input data (assuming unsigned bytes) matching the given codec into Self.

fn to_signed_bytes_be(&self) -> (impl AsRef<[u8]>, usize)

Returns a minimum number of signed Big Endian bytes needed to present the integer, byte count defined by usize.

fn to_unsigned_bytes_be(&self) -> (impl AsRef<[u8]>, usize)

Returns minimum number defined by usize of unsigned Big-endian bytes needed to present the the integer.

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

Makes it possible to add unsigned integer to signed integer This is mainly used on UPER, in order to add unsigned offset into signed constrained minimum to get the resulting value as correct type. Casting will change the “value”, but same width makes the result ending to be correct.

fn is_negative(&self) -> bool

Whether the integer value is negative or not.

fn is_signed(&self) -> bool

Whether the integer type is signed or not.

fn to_integer(self) -> Integer

Convert the underlying integer type into rasn ASN.1 Integer type.

const BYTE_WIDTH: usize = _

The byte level width of the integer(e.g. u32 is 4 bytes).

impl Ord for Integer

fn cmp(&self, other: &Integer) -> 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 Integer

fn eq(&self, other: &Self) -> 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 Integer

fn partial_cmp(&self, other: &Integer) -> 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 Sub<i128> for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: i128) -> Self::Output

Performs the - operation.

impl Sub<i16> for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: i16) -> Self::Output

Performs the - operation.

impl Sub<i32> for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: i32) -> Self::Output

Performs the - operation.

impl Sub<i64> for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: i64) -> Self::Output

Performs the - operation.

impl Sub<i8> for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: i8) -> Self::Output

Performs the - operation.

impl Sub<isize> for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: isize) -> Self::Output

Performs the - operation.

impl Sub<u128> for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: u128) -> Self::Output

Performs the - operation.

impl Sub<u16> for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: u16) -> Self::Output

Performs the - operation.

impl Sub<u32> for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: u32) -> Self::Output

Performs the - operation.

impl Sub<u64> for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: u64) -> Self::Output

Performs the - operation.

impl Sub<u8> for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: u8) -> Self::Output

Performs the - operation.

impl Sub<usize> for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: usize) -> Self::Output

Performs the - operation.

impl Sub for Integer

type Output = Integer

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl ToBigInt for Integer

fn to_bigint(&self) -> Option<BigInt>

Converts the value of self to a BigInt.

impl ToPrimitive for Integer

fn to_i64(&self) -> Option<i64>

Converts the value of self to an i64. If the value cannot be represented by an i64, then None is returned.

fn to_u64(&self) -> Option<u64>

Converts the value of self to a u64. If the value cannot be represented by a u64, then None is returned.

fn to_i128(&self) -> Option<i128>

Converts the value of self to an i128. If the value cannot be represented by an i128 (i64 under the default implementation), then None is returned.

fn to_isize(&self) -> Option<isize>

Converts the value of self to an isize. If the value cannot be represented by an isize, then None is returned.

fn to_i8(&self) -> Option<i8>

Converts the value of self to an i8. If the value cannot be represented by an i8, then None is returned.

fn to_i16(&self) -> Option<i16>

Converts the value of self to an i16. If the value cannot be represented by an i16, then None is returned.

fn to_i32(&self) -> Option<i32>

Converts the value of self to an i32. If the value cannot be represented by an i32, then None is returned.

fn to_usize(&self) -> Option<usize>

Converts the value of self to a usize. If the value cannot be represented by a usize, then None is returned.

fn to_u8(&self) -> Option<u8>

Converts the value of self to a u8. If the value cannot be represented by a u8, then None is returned.

fn to_u16(&self) -> Option<u16>

Converts the value of self to a u16. If the value cannot be represented by a u16, then None is returned.

fn to_u32(&self) -> Option<u32>

Converts the value of self to a u32. If the value cannot be represented by a u32, then None is returned.

fn to_u128(&self) -> Option<u128>

Converts the value of self to a u128. If the value cannot be represented by a u128 (u64 under the default implementation), then None is returned.

fn to_f32(&self) -> Option<f32>

Converts the value of self to an f32. Overflows may map to positive or negative inifinity, otherwise None is returned if the value cannot be represented by an f32.

fn to_f64(&self) -> Option<f64>

Converts the value of self to an f64. Overflows may map to positive or negative inifinity, otherwise None is returned if the value cannot be represented by an f64.

impl TryFrom<&Integer> for i128

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: &Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Integer> for i16

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: &Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Integer> for i32

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: &Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Integer> for i64

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: &Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Integer> for i8

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: &Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Integer> for isize

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: &Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Integer> for u128

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: &Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Integer> for u16

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: &Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Integer> for u32

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: &Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Integer> for u64

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: &Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Integer> for u8

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: &Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Integer> for usize

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: &Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Integer> for i128

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Integer> for i16

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Integer> for i32

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Integer> for i64

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Integer> for i8

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Integer> for isize

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Integer> for u128

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Integer> for u16

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Integer> for u32

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Integer> for u64

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Integer> for u8

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Integer> for usize

type Error = TryFromIntegerError

The type returned in the event of a conversion error.

fn try_from(value: Integer) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Integer