Struct 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]);

Struct Integer Copy item path

§Note

§Examples

Implementations§

impl<'a> Integer<'a>

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

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

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

impl Integer<'_>

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

impl Integer<'_>

pub fn from_i8(i: i8) -> Self

impl Integer<'_>

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

impl Integer<'_>

pub fn from_i16(i: i16) -> Self

impl Integer<'_>

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

impl Integer<'_>

pub fn from_i32(i: i32) -> Self

impl Integer<'_>

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

impl Integer<'_>

pub fn from_i64(i: i64) -> Self

impl Integer<'_>

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

impl Integer<'_>

pub fn from_i128(i: i128) -> Self

impl Integer<'_>

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

impl Integer<'_>

pub fn from_u8(i: u8) -> Self

impl Integer<'_>

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

impl Integer<'_>

pub fn from_u16(i: u16) -> Self

impl Integer<'_>

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

impl Integer<'_>

pub fn from_u32(i: u32) -> Self

impl Integer<'_>

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

impl Integer<'_>

pub fn from_u64(i: u64) -> Self

impl Integer<'_>

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

impl Integer<'_>

pub fn from_u128(i: u128) -> Self

Trait Implementations§

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

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

impl CheckDerConstraints for Integer<'_>

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

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

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

impl From<i128> for Integer<'_>

fn from(i: i128) -> Self

impl From<i16> for Integer<'_>

fn from(i: i16) -> Self

impl From<i32> for Integer<'_>

fn from(i: i32) -> Self

impl From<i64> for Integer<'_>

fn from(i: i64) -> Self

impl From<i8> for Integer<'_>

fn from(i: i8) -> Self

impl From<u128> for Integer<'_>

fn from(i: u128) -> Self

impl From<u16> for Integer<'_>

fn from(i: u16) -> Self

impl From<u32> for Integer<'_>

fn from(i: u32) -> Self

impl From<u64> for Integer<'_>

fn from(i: u64) -> Self

impl From<u8> for Integer<'_>

fn from(i: u8) -> Self

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

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

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

impl Tagged for Integer<'_>

const TAG: Tag = Tag::Integer

Struct Integer

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

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

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