Struct bsn1::Der

pub struct Der { /* fields omitted */ }

Der owns DerRef and represents DER.

Implementations

impl Der

pub fn new(id: &IdRef, contents: &[u8]) -> Self

Creates a new instance from id and contents .

Warnings

ASN.1 does not allow some universal identifier for DER, however, this function accepts such an identifier. For example, ‘Octet String’ must be primitive in DER, but this function will construct a new instance even if id represenets constructed ‘Octet String.’

Examples

use bsn1::{Der, IdRef};

let id = IdRef::octet_string();
let contents: &[u8] = &[10, 20, 30];

let der = Der::new(id, contents);

assert_eq!(id, der.id());
assert_eq!(contents, der.contents());

pub fn from_id_iterator<I>(id: &IdRef, contents: I) -> Self where
    I: Iterator + Clone,
    I::Item: AsRef<[u8]>, 

Creates a new instance from id and contents .

Warnings

ASN.1 does not allow some universal identifier for DER, however, this function accepts such an identifier. For example, ‘Octet String’ must be primitive in DER, but this function will construct a new instance even if id represenets constructed ‘Octet String.’

Examples

use bsn1::{Der, IdRef};

let id = IdRef::sequence();

// Build instance using function 'from_id_iterator()'.
let contents: &[Der] = &[Der::utf8_string("foo"), Der::integer(29)];
let der = Der::from_id_iterator(id, contents.iter());

// Build instance using function 'new()'.
let contents: Vec<u8> = contents.iter()
                        .map(|i| Vec::from(i.as_ref() as &[u8]))
                        .flatten().collect();
let expected = Der::new(id, &contents);

assert_eq!(expected, der);

pub fn boolean(val: bool) -> Self

Returns a new instance representing boolean.

Examples

use bsn1::{contents, Der, IdRef};

let val = true;
let der = Der::boolean(val);

assert_eq!(IdRef::boolean(), der.id());
assert_eq!(val, contents::to_bool_der(der.contents()).unwrap());

pub fn integer(val: i128) -> Self

Returns a new instance representing ingeger.

Examples

use bsn1::{contents, Der, IdRef};

let val = 39;
let der = Der::integer(val);

assert_eq!(IdRef::integer(), der.id());
assert_eq!(val, contents::to_integer(der.contents()).unwrap());

pub fn utf8_string(val: &str) -> Self

Returns a new instance representing utf8_string.

Examples

use bsn1::{Der, IdRef};

let val = &"foo";
let der = Der::utf8_string(val);

assert_eq!(IdRef::utf8_string(), der.id());
assert_eq!(val.as_bytes(), der.contents());

pub fn octet_string(val: &[u8]) -> Self

Returns a new instance representing octet_string.

Examples

use bsn1::{Der, IdRef};

let val = &[1, 2, 3];
let der = Der::octet_string(val);

assert_eq!(IdRef::octet_string(), der.id());
assert_eq!(val, der.contents());

impl Der

pub fn into_vec(self) -> Vec<u8>

Consumes self , returning Vec .

Examples

use bsn1::{Der, IdRef};

let id = IdRef::octet_string();
let contents: &[u8] = &[0, 1, 2, 3, 4];

let der = Der::new(id, contents);
let v = der.clone().into_vec();

assert_eq!(der.as_ref() as &[u8], v.as_ref() as &[u8]);

Methods from Deref<Target = DerRef>

pub fn id(&self) -> &IdRef

Returns a reference to IdRef of self .

Examples

use bsn1::{Der, IdRef};

let id = IdRef::octet_string();
let contents = &[1, 2, 3];

// 'DER' implements 'Deref<Target=DerRef>'
let der = Der::new(id, contents);
assert_eq!(id, der.id());

pub fn length(&self) -> Length

Returns Length to represent the length of contents.

Note that DER does not allow indefinite Length. The return value must be Length::Definite .

Warnings

Length stands for the length octets in DER. The total bytes is greater than the value.

Examples

use bsn1::{Der, IdRef, Length};

let id = IdRef::octet_string();
let contents = &[1, 2, 3];

// 'DER' implements 'Deref<Target=DerRef>'
let der = Der::new(id, contents);
assert_eq!(Length::Definite(contents.len()), der.length());

pub fn contents(&self) -> &[u8]

Returns a reference to the contents octets of self .

Examples

use bsn1::{Der, IdRef};

let id = IdRef::octet_string();
let contents = &[1, 2, 3];

// 'DER' implements 'Deref<Target=DerRef>'
let der = Der::new(id, contents);
assert_eq!(contents, der.contents());

Trait Implementations

impl AsRef<[u8]> for Der

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

Performs the conversion.

impl AsRef<DerRef> for Der

fn as_ref(&self) -> &DerRef

Performs the conversion.

impl Borrow<[u8]> for Der

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

Immutably borrows from an owned value.

impl Borrow<DerRef> for Der

fn borrow(&self) -> &DerRef

Immutably borrows from an owned value.

impl Clone for Der

fn clone(&self) -> Der

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Der

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

Formats the value using the given formatter.

impl Deref for Der

type Target = DerRef

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Eq for Der

impl From<&'_ DerRef> for Der

fn from(der_ref: &DerRef) -> Self

Performs the conversion.

impl From<Der> for Ber

fn from(der: Der) -> Self

Performs the conversion.

impl PartialEq<Der> for Der

fn eq(&self, other: &Der) -> bool

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

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

This method tests for !=.

impl StructuralEq for Der

impl StructuralPartialEq for Der

impl TryFrom<&'_ [u8]> for Der

type Error = Error

The type returned in the event of a conversion error.

fn try_from(bytes: &[u8]) -> Result<Self, Self::Error>

Parses bytes starting with DER octets and builds a new instance.

This function ignores extra octet(s) at the end of bytes if any.

Warnings

ASN.1 does not allow some universal identifier for DER, however, this function accepts such an identifier. For example, ‘Octet String’ must be primitive in DER, but this function returns Ok for constructed Octet String DER.