Struct asn1_rs::Integer

source ·
pub struct Integer<'a> { /* private fields */ }
Expand description

ASN.1 INTEGER type

Generic representation for integer types. BER/DER integers can be of any size, so it is not possible to store them as simple integers (they are stored as raw bytes).

The internal representation can be obtained using .as_ref().

§Note

Methods from/to BER and DER encodings are also implemented for primitive types (u8, u16 to u128, and i8 to i128). In most cases, it is easier to use these types directly.

§Examples

Creating an Integer

use asn1_rs::Integer;

// unsigned
let i = Integer::from(4);
assert_eq!(i.as_ref(), &[4]);
// signed
let j = Integer::from(-2);
assert_eq!(j.as_ref(), &[0xfe]);

Converting an Integer to a primitive type (using the TryInto trait)

use asn1_rs::{Error, Integer};
use std::convert::TryInto;

let i = Integer::new(&[0x12, 0x34, 0x56, 0x78]);
// converts to an u32
let n: u32 = i.try_into().unwrap();

// Same, but converting to an u16: will fail, value cannot fit into an u16
let i = Integer::new(&[0x12, 0x34, 0x56, 0x78]);
assert_eq!(i.try_into() as Result<u16, _>, Err(Error::IntegerTooLarge));

Encoding an Integer to DER

use asn1_rs::{Integer, ToDer};

let i = Integer::from(4);
let v = i.to_der_vec().unwrap();
assert_eq!(&v, &[2, 1, 4]);

// same, with primitive types
let v = 4.to_der_vec().unwrap();
assert_eq!(&v, &[2, 1, 4]);

Implementations§

source§

impl<'a> Integer<'a>

source

pub const fn new(s: &'a [u8]) -> Self

Creates a new Integer containing the given value (borrowed).

source

pub fn any(&'a self) -> Any<'a>

Creates a borrowed Any for this object

source

pub fn from_const_array<const N: usize>(b: [u8; N]) -> Self

Build an Integer from a constant array of bytes representation of an integer.

source§

impl Integer<'_>

source

pub fn as_i8(&self) -> Result<i8>

Attempts to convert an Integer to a i8.

This function returns an IntegerTooLarge error if the integer will not fit into the output type.

source§

impl Integer<'_>

source

pub fn from_i8(i: i8) -> Self

Converts a i8 to an Integer

Note: this function allocates data.

source§

impl Integer<'_>

source

pub fn as_i16(&self) -> Result<i16>

Attempts to convert an Integer to a i16.

This function returns an IntegerTooLarge error if the integer will not fit into the output type.

source§

impl Integer<'_>

source

pub fn from_i16(i: i16) -> Self

Converts a i16 to an Integer

Note: this function allocates data.

source§

impl Integer<'_>

source

pub fn as_i32(&self) -> Result<i32>

Attempts to convert an Integer to a i32.

This function returns an IntegerTooLarge error if the integer will not fit into the output type.

source§

impl Integer<'_>

source

pub fn from_i32(i: i32) -> Self

Converts a i32 to an Integer

Note: this function allocates data.

source§

impl Integer<'_>

source

pub fn as_i64(&self) -> Result<i64>

Attempts to convert an Integer to a i64.

This function returns an IntegerTooLarge error if the integer will not fit into the output type.

source§

impl Integer<'_>

source

pub fn from_i64(i: i64) -> Self

Converts a i64 to an Integer

Note: this function allocates data.

source§

impl Integer<'_>

source

pub fn as_i128(&self) -> Result<i128>

Attempts to convert an Integer to a i128.

This function returns an IntegerTooLarge error if the integer will not fit into the output type.

source§

impl Integer<'_>

source

pub fn from_i128(i: i128) -> Self

Converts a i128 to an Integer

Note: this function allocates data.

source§

impl Integer<'_>

source

pub fn as_u8(&self) -> Result<u8>

Attempts to convert an Integer to a u8.

This function returns an IntegerTooLarge error if the integer will not fit into the output type.

source§

impl Integer<'_>

source

pub fn from_u8(i: u8) -> Self

Converts a u8 to an Integer

Note: this function allocates data.

source§

impl Integer<'_>

source

pub fn as_u16(&self) -> Result<u16>

Attempts to convert an Integer to a u16.

This function returns an IntegerTooLarge error if the integer will not fit into the output type.

source§

impl Integer<'_>

source

pub fn from_u16(i: u16) -> Self

Converts a u16 to an Integer

Note: this function allocates data.

source§

impl Integer<'_>

source

pub fn as_u32(&self) -> Result<u32>

Attempts to convert an Integer to a u32.

This function returns an IntegerTooLarge error if the integer will not fit into the output type.

source§

impl Integer<'_>

source

pub fn from_u32(i: u32) -> Self

Converts a u32 to an Integer

Note: this function allocates data.

source§

impl Integer<'_>

source

pub fn as_u64(&self) -> Result<u64>

Attempts to convert an Integer to a u64.

This function returns an IntegerTooLarge error if the integer will not fit into the output type.

source§

impl Integer<'_>

source

pub fn from_u64(i: u64) -> Self

Converts a u64 to an Integer

Note: this function allocates data.

source§

impl Integer<'_>

source

pub fn as_u128(&self) -> Result<u128>

Attempts to convert an Integer to a u128.

This function returns an IntegerTooLarge error if the integer will not fit into the output type.

source§

impl Integer<'_>

source

pub fn from_u128(i: u128) -> Self

Converts a u128 to an Integer

Note: this function allocates data.

Trait Implementations§

source§

impl<'a> AsRef<[u8]> for Integer<'a>

source§

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.
source§

impl<'a> CheckDerConstraints for Integer<'a>

source§

impl<'a> Debug for Integer<'a>

source§

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

Formats the value using the given formatter. Read more
source§

impl From<i128> for Integer<'_>

source§

fn from(i: i128) -> Self

Converts to this type from the input type.
source§

impl From<i16> for Integer<'_>

source§

fn from(i: i16) -> Self

Converts to this type from the input type.
source§

impl From<i32> for Integer<'_>

source§

fn from(i: i32) -> Self

Converts to this type from the input type.
source§

impl From<i64> for Integer<'_>

source§

fn from(i: i64) -> Self

Converts to this type from the input type.
source§

impl From<i8> for Integer<'_>

source§

fn from(i: i8) -> Self

Converts to this type from the input type.
source§

impl From<u128> for Integer<'_>

source§

fn from(i: u128) -> Self

Converts to this type from the input type.
source§

impl From<u16> for Integer<'_>

source§

fn from(i: u16) -> Self

Converts to this type from the input type.
source§

impl From<u32> for Integer<'_>

source§

fn from(i: u32) -> Self

Converts to this type from the input type.
source§

impl From<u64> for Integer<'_>

source§

fn from(i: u64) -> Self

Converts to this type from the input type.
source§

impl From<u8> for Integer<'_>

source§

fn from(i: u8) -> Self

Converts to this type from the input type.
source§

impl<'a> PartialEq for Integer<'a>

source§

fn eq(&self, other: &Integer<'a>) -> bool

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<'a> Tagged for Integer<'a>

source§

const TAG: Tag = Tag::Integer

source§

impl ToDer for Integer<'_>

source§

fn to_der_len(&self) -> Result<usize>

Get the length of the object (including the header), when encoded
source§

fn write_der_header(&self, writer: &mut dyn Write) -> SerializeResult<usize>

Attempt to write the DER header to this writer.
source§

fn write_der_content(&self, writer: &mut dyn Write) -> SerializeResult<usize>

Attempt to write the DER content (all except header) to this writer.
source§

fn to_der_vec(&self) -> SerializeResult<Vec<u8>>

Write the DER encoded representation to a newly allocated Vec<u8>.
source§

fn to_der_vec_raw(&self) -> SerializeResult<Vec<u8>>

Similar to using to_vec, but uses provided values without changes. This can generate an invalid encoding for a DER object.
source§

fn write_der(&self, writer: &mut dyn Write) -> SerializeResult<usize>

Attempt to write the DER encoded representation (header and content) into this writer. Read more
source§

fn write_der_raw(&self, writer: &mut dyn Write) -> SerializeResult<usize>

Similar to using to_der, but uses provided values without changes. This can generate an invalid encoding for a DER object.
source§

impl<'a, 'b> TryFrom<&'b Any<'a>> for Integer<'a>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: &'b Any<'a>) -> Result<Integer<'a>>

Performs the conversion.
source§

impl<'a> TryFrom<Any<'a>> for Integer<'a>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: Any<'a>) -> Result<Integer<'a>>

Performs the conversion.
source§

impl TryFrom<Integer<'_>> for i128

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: Integer<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<Integer<'_>> for i16

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: Integer<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<Integer<'_>> for i32

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: Integer<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<Integer<'_>> for i64

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: Integer<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<Integer<'_>> for i8

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: Integer<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<Integer<'_>> for u128

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: Integer<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<Integer<'_>> for u16

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: Integer<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<Integer<'_>> for u32

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: Integer<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<Integer<'_>> for u64

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: Integer<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<Integer<'_>> for u8

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: Integer<'_>) -> Result<Self>

Performs the conversion.
source§

impl DerAutoDerive for Integer<'_>

source§

impl<'a> Eq for Integer<'a>

source§

impl<'a> StructuralPartialEq for Integer<'a>

Auto Trait Implementations§

§

impl<'a> Freeze for Integer<'a>

§

impl<'a> RefUnwindSafe for Integer<'a>

§

impl<'a> Send for Integer<'a>

§

impl<'a> Sync for Integer<'a>

§

impl<'a> Unpin for Integer<'a>

§

impl<'a> UnwindSafe for Integer<'a>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

source§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

source§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

source§

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> Choice for T
where T: Tagged,

source§

fn can_decode(tag: Tag) -> bool

Is the provided Tag decodable as a variant of this CHOICE?
source§

impl<T> DynTagged for T
where T: Tagged,

source§

fn tag(&self) -> Tag

source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<'a, T, E> FromBer<'a, E> for T
where T: TryFrom<Any<'a>, Error = E>, E: From<Error>,

source§

fn from_ber(bytes: &'a [u8]) -> Result<(&'a [u8], T), Err<E>>

Attempt to parse input bytes into a BER object
source§

impl<'a, T, E> FromDer<'a, E> for T
where T: TryFrom<Any<'a>, Error = E> + CheckDerConstraints + DerAutoDerive, E: From<Error> + Display + Debug,

source§

fn from_der(bytes: &'a [u8]) -> Result<(&'a [u8], T), Err<E>>

Attempt to parse input bytes into a DER object (enforcing constraints)
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.