Struct bsn1::Ber

pub struct Ber { /* fields omitted */ }

Ber owns BerRef and represents a BER.

Implementations

impl Ber

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

Creates a new instance from id and contents with definite length.

Note that BER allows both definite and indefinite length, however, the length of return value is always definite. (Generally speaking, the performance of definite length is better than that of indefinite length. Indefinite length is seldom used these days.)

Examples

use bsn1::{Ber, IdRef};

let id = IdRef::octet_string();
let _ber = Ber::new(id, &[]);

impl Ber

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

Consumes self , returning Vec .

Examples

use bsn1::{Ber, IdRef};

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

let ber = Ber::new(id, contents);
let v = ber.clone().into_vec();

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

Methods from Deref<Target = BerRef>

pub fn id(&self) -> &IdRef

Provides a reference to the IdRef of self .

Examples

use bsn1::{Ber, BerRef, IdRef};

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

// 'Ber' implements 'Deref<Target=BerRef>.'
let ber = Ber::new(id, contents);
assert_eq!(id, ber.id());

pub fn length(&self) -> Length

Returns Length of self .

Warnings

Length stands for 'the length of the contents' in BER. The length of the total bytes is greater than the value.

Examples

use bsn1::{Ber, BerRef, IdRef, Length};

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

// 'Ber' implements 'Deref<Target=BerRef>.'
let ber = Ber::new(id, contents);
assert_eq!(Length::Definite(contents.len()), ber.length());

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

Provides a reference to the 'contents' of self .

Examples

use bsn1::{Ber, BerRef, IdRef};

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

// 'Ber' implements 'Deref<Target=BerRef>.'
let ber = Ber::new(id, contents);
assert_eq!(contents, ber.contents());

Trait Implementations

impl AsRef<[u8]> for Ber

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

Performs the conversion.

impl AsRef<BerRef> for Ber

fn as_ref(&self) -> &BerRef

Performs the conversion.

impl Borrow<[u8]> for Ber

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

Immutably borrows from an owned value.

impl Borrow<BerRef> for Ber

fn borrow(&self) -> &BerRef

Immutably borrows from an owned value.

impl Clone for Ber

fn clone(&self) -> Ber

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Ber

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

Formats the value using the given formatter.

impl Deref for Ber

type Target = BerRef

The resulting type after dereferencing.

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

Dereferences the value.

impl Eq for Ber

impl<'_> From<&'_ BerRef> for Ber

fn from(ber_ref: &BerRef) -> Self

Performs the conversion.

impl<'_> From<&'_ DerRef> for Ber

fn from(der: &DerRef) -> Self

Performs the conversion.

impl From<Der> for Ber

fn from(der: Der) -> Self

Performs the conversion.

impl PartialEq<Ber> for Ber

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

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

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

This method tests for !=.

impl StructuralEq for Ber

impl StructuralPartialEq for Ber

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

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 octets of 'ASN.1 BER' and returns a new instance.

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