Struct rocket::mtls::oid::asn1_rs::Integer

pub struct Integer<'a> { /* private fields */ }

Available on crate feature mtls only.

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(), &[0x0, 0xff, 0xff, 0xff, 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

impl<'a> Integer<'a>

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

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

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

Creates a borrowed Any for this object

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

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

impl<'_> Integer<'_>

pub fn from_i8(i: i8) -> Integer<'_>

Converts a i8 to an Integer

Note: this function allocates data.

impl<'_> Integer<'_>

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

Attempts to convert an Integer to a i8.

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

impl<'_> Integer<'_>

pub fn from_i16(i: i16) -> Integer<'_>

Converts a i16 to an Integer

Note: this function allocates data.

impl<'_> Integer<'_>

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

Attempts to convert an Integer to a i16.

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

impl<'_> Integer<'_>

pub fn from_i32(i: i32) -> Integer<'_>

Converts a i32 to an Integer

Note: this function allocates data.

impl<'_> Integer<'_>

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

Attempts to convert an Integer to a i32.

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

impl<'_> Integer<'_>

pub fn from_i64(i: i64) -> Integer<'_>

Converts a i64 to an Integer

Note: this function allocates data.

impl<'_> Integer<'_>

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

Attempts to convert an Integer to a i64.

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

impl<'_> Integer<'_>

pub fn from_i128(i: i128) -> Integer<'_>

Converts a i128 to an Integer

Note: this function allocates data.

impl<'_> Integer<'_>

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

Attempts to convert an Integer to a i128.

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

impl<'_> Integer<'_>

pub fn from_u8(i: u8) -> Integer<'_>

Converts a u8 to an Integer

Note: this function allocates data.

impl<'_> Integer<'_>

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

Attempts to convert an Integer to a u8.

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

impl<'_> Integer<'_>

pub fn from_u16(i: u16) -> Integer<'_>

Converts a u16 to an Integer

Note: this function allocates data.

impl<'_> Integer<'_>

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

Attempts to convert an Integer to a u16.

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

impl<'_> Integer<'_>

pub fn from_u32(i: u32) -> Integer<'_>

Converts a u32 to an Integer

Note: this function allocates data.

impl<'_> Integer<'_>

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

Attempts to convert an Integer to a u32.

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

impl<'_> Integer<'_>

pub fn from_u64(i: u64) -> Integer<'_>

Converts a u64 to an Integer

Note: this function allocates data.

impl<'_> Integer<'_>

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

Attempts to convert an Integer to a u64.

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

impl<'_> Integer<'_>

pub fn from_u128(i: u128) -> Integer<'_>

Converts a u128 to an Integer

Note: this function allocates data.

impl<'_> Integer<'_>

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

Attempts to convert an Integer to a u128.

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

Trait Implementations

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

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

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

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

fn check_constraints(any: &Any<'_>) -> Result<(), Error>

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

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

Formats the value using the given formatter.

impl<'_> From<i128> for Integer<'_>

fn from(i: i128) -> Integer<'_>

Converts to this type from the input type.

impl<'_> From<i16> for Integer<'_>

fn from(i: i16) -> Integer<'_>

Converts to this type from the input type.

impl<'_> From<i32> for Integer<'_>

fn from(i: i32) -> Integer<'_>

Converts to this type from the input type.

impl<'_> From<i64> for Integer<'_>

fn from(i: i64) -> Integer<'_>

Converts to this type from the input type.

impl<'_> From<i8> for Integer<'_>

fn from(i: i8) -> Integer<'_>

Converts to this type from the input type.

impl<'_> From<u128> for Integer<'_>

fn from(i: u128) -> Integer<'_>

Converts to this type from the input type.

impl<'_> From<u16> for Integer<'_>

fn from(i: u16) -> Integer<'_>

Converts to this type from the input type.

impl<'_> From<u32> for Integer<'_>

fn from(i: u32) -> Integer<'_>

Converts to this type from the input type.

impl<'_> From<u64> for Integer<'_>

fn from(i: u64) -> Integer<'_>

Converts to this type from the input type.

impl<'_> From<u8> for Integer<'_>

fn from(i: u8) -> Integer<'_>

Converts to this type from the input type.

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

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

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

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

This method tests for !=.

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

const TAG: Tag = Tag::Integer

impl<'_> ToDer for Integer<'_>

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

Get the length of the object, when encoded

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

Attempt to write the DER header to this writer.

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

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

fn to_der_vec(&self) -> Result<Vec<u8, Global>, SerializeError>

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

fn to_der_vec_raw(&self) -> Result<Vec<u8, Global>, SerializeError>

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

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

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

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

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

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl<'_> TryFrom<Integer<'_>> for u128

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Integer<'_>) -> Result<u128, Error>

Performs the conversion.

impl<'_> TryFrom<Integer<'_>> for u32

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Integer<'_>) -> Result<u32, Error>

Performs the conversion.

impl<'_> TryFrom<Integer<'_>> for u8

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Integer<'_>) -> Result<u8, Error>

Performs the conversion.

impl<'_> TryFrom<Integer<'_>> for i16

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Integer<'_>) -> Result<i16, Error>

Performs the conversion.

impl<'_> TryFrom<Integer<'_>> for i32

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Integer<'_>) -> Result<i32, Error>

Performs the conversion.

impl<'_> TryFrom<Integer<'_>> for u64

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Integer<'_>) -> Result<u64, Error>

Performs the conversion.

impl<'_> TryFrom<Integer<'_>> for i64

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Integer<'_>) -> Result<i64, Error>

Performs the conversion.

impl<'_> TryFrom<Integer<'_>> for i8

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Integer<'_>) -> Result<i8, Error>

Performs the conversion.

impl<'_> TryFrom<Integer<'_>> for i128

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Integer<'_>) -> Result<i128, Error>

Performs the conversion.

impl<'_> TryFrom<Integer<'_>> for u16

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Integer<'_>) -> Result<u16, Error>

Performs the conversion.

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

impl<'a> StructuralEq for Integer<'a>

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