Struct asn1_rs::Header

source · [−]

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

Expand description

BER/DER object header (identifier and length)

Implementations

source

impl<'a> Header<'a>

source

pub const fn new(
    class: Class,
    constructed: bool,
    tag: Tag,
    length: Length
) -> Self

Build a new BER/DER header from the provided values

source

pub const fn new_simple(tag: Tag) -> Self

Build a new BER/DER header from the provided tag, with default values for other fields

source

pub fn with_class(self, class: Class) -> Self

Set the class of this Header

source

pub fn with_constructed(self, constructed: bool) -> Self

Set the constructed flags of this Header

source

pub fn with_tag(self, tag: Tag) -> Self

Set the tag of this Header

source

pub fn with_length(self, length: Length) -> Self

Set the length of this Header

source

pub fn with_raw_tag(self, raw_tag: Option<Cow<'a, [u8]>>) -> Self

Update header to add reference to raw tag

source

pub const fn class(&self) -> Class

Return the class of this header.

source

pub const fn constructed(&self) -> bool

Return true if this header has the ‘constructed’ flag.

source

pub const fn tag(&self) -> Tag

Return the tag of this header.

source

pub const fn length(&self) -> Length

Return the length of this header.

source

pub fn raw_tag(&self) -> Option<&[u8]>

Return the raw tag encoding, if it was stored in this object

source

pub const fn is_primitive(&self) -> bool

Test if object is primitive

source

pub const fn is_constructed(&self) -> bool

Test if object is constructed

source

pub const fn assert_class(&self, class: Class) -> Result<()>

Return error if class is not the expected class

source

pub const fn assert_tag(&self, tag: Tag) -> Result<()>

Return error if tag is not the expected tag

source

pub const fn assert_primitive(&self) -> Result<()>

Return error if object is not primitive

source

pub const fn assert_constructed(&self) -> Result<()>

Return error if object is primitive

source

pub const fn is_universal(&self) -> bool

Test if object class is Universal

source

pub const fn is_application(&self) -> bool

Test if object class is Application

source

pub const fn is_contextspecific(&self) -> bool

Test if object class is Context-specific

source

pub const fn is_private(&self) -> bool

Test if object class is Private

source

pub const fn assert_definite(&self) -> Result<()>

Return error if object length is definite

source

pub fn parse_ber_content<'i>(&self, i: &'i [u8]) -> ParseResult<'i, &'i [u8]>

Get the content following a BER header

source

pub fn parse_der_content<'i>(&self, i: &'i [u8]) -> ParseResult<'i, &'i [u8]>

Get the content following a DER header

Trait Implementations

source

impl<'a> Clone for Header<'a>

source

fn clone(&self) -> Header<'a>

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

source

impl<'a> Debug for Header<'a>

source

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

Formats the value using the given formatter. Read more

source

fn from(tag: Tag) -> Self

Converts to this type from the input type.

source

impl<'a> FromBer<'a, Error> for Header<'a>

source

fn from_ber(bytes: &'a [u8]) -> ParseResult<'_, Self>

Attempt to parse input bytes into a BER object

source

impl<'a> FromDer<'a, Error> for Header<'a>

source

fn from_der(bytes: &'a [u8]) -> ParseResult<'_, Self>

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

source

impl<'a> PartialEq<Header<'a>> for Header<'a>

Compare two BER headers. len fields are compared only if both objects have it set (same for raw_tag)

source

fn eq(&self, other: &Header<'_>) -> bool

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

1.0.0 · source

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

This method tests for !=.

source

impl ToDer for Header<'_>

source

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

Get the length of the object, when encoded Read more

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 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. Read more

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. Read more

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

impl<'a> ToStatic for Header<'a>

type Owned = Header<'static>

source

fn to_static(&self) -> Self::Owned

source

impl Eq for Header<'_>

Auto Trait Implementations

impl<'a> RefUnwindSafe for Header<'a>

impl<'a> Send for Header<'a>

impl<'a> Sync for Header<'a>

impl<'a> Unpin for Header<'a>

impl<'a> UnwindSafe for Header<'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<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

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

const: unstable · source

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

Mutably borrows from an owned value. Read more

impl<T> Conv for T

fn conv<T>(self) -> T where
Self: Into<T>,

Converts self into T using Into<T>. Read more

impl<T> FmtForward for T

fn fmt_binary(self) -> FmtBinary<Self> where
Self: Binary,

Causes self to use its Binary implementation when Debug-formatted. Read more

fn fmt_display(self) -> FmtDisplay<Self> where
Self: Display,

Causes self to use its Display implementation when Debug-formatted. Read more

fn fmt_lower_exp(self) -> FmtLowerExp<Self> where
Self: LowerExp,

Causes self to use its LowerExp implementation when Debug-formatted. Read more

fn fmt_lower_hex(self) -> FmtLowerHex<Self> where
Self: LowerHex,

Causes self to use its LowerHex implementation when Debug-formatted. Read more

fn fmt_octal(self) -> FmtOctal<Self> where
Self: Octal,

Causes self to use its Octal implementation when Debug-formatted. Read more

fn fmt_pointer(self) -> FmtPointer<Self> where
Self: Pointer,

Causes self to use its Pointer implementation when Debug-formatted. Read more

fn fmt_upper_exp(self) -> FmtUpperExp<Self> where
Self: UpperExp,

Causes self to use its UpperExp implementation when Debug-formatted. Read more

fn fmt_upper_hex(self) -> FmtUpperHex<Self> where
Self: UpperHex,

Causes self to use its UpperHex implementation when Debug-formatted. Read more

fn fmt_list(self) -> FmtList<Self> where
&'a Self: for<'a> IntoIterator,

Formats each item in a sequence. Read more

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

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

const: unstable · 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.

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

fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R

Pipes by value. This is generally the method you want to use. Read more

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R where
R: 'a,

Borrows self and passes that borrow into the pipe function. Read more

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R where
R: 'a,

Mutably borrows self and passes that borrow into the pipe function. Read more

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R where
 Self: Borrow,
 B: 'a + ?Sized,
 R: 'a,

Borrows self, then passes self.borrow() into the pipe function. Read more

fn pipe_borrow_mut<'a, B, R>(
 &'a mut self,
 func: impl FnOnce(&'a mut B) -> R
) -> R where
 Self: BorrowMut,
 B: 'a + ?Sized,
 R: 'a,

Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R where
 Self: AsRef,
 U: 'a + ?Sized,
 R: 'a,

Borrows self, then passes self.as_ref() into the pipe function.

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R where
 Self: AsMut,
 U: 'a + ?Sized,
 R: 'a,

Mutably borrows self, then passes self.as_mut() into the pipe function. Read more

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R where
 Self: Deref<Target = T>,
 T: 'a + ?Sized,
 R: 'a,

Borrows self, then passes self.deref() into the pipe function.

fn pipe_deref_mut<'a, T, R>(
 &'a mut self,
 func: impl FnOnce(&'a mut T) -> R
) -> R where
 Self: DerefMut<Target = T> + Deref,
 T: 'a + ?Sized,
 R: 'a,

Mutably borrows self, then passes self.deref_mut() into the pipe function. Read more

impl<T> Tap for T

fn tap(self, func: impl FnOnce(&Self)) -> Self

Immutable access to a value. Read more

fn tap_mut(self, func: impl FnOnce(&mut Self)) -> Self

Mutable access to a value. Read more

fn tap_borrow(self, func: impl FnOnce(&B)) -> Self where
Self: Borrow,
B: ?Sized,

Immutable access to the Borrow of a value. Read more

fn tap_borrow_mut(self, func: impl FnOnce(&mut B)) -> Self where
Self: BorrowMut,
B: ?Sized,

Mutable access to the BorrowMut of a value. Read more

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self where
Self: AsRef<R>,
R: ?Sized,

Immutable access to the AsRef<R> view of a value. Read more

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self where
Self: AsMut<R>,
R: ?Sized,

Mutable access to the AsMut<R> view of a value. Read more

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self where
Self: Deref<Target = T>,
T: ?Sized,

Immutable access to the Deref::Target of a value. Read more

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self where
Self: DerefMut<Target = T> + Deref,
T: ?Sized,

Mutable access to the Deref::Target of a value. Read more

fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self

Calls .tap() only in debug builds, and is erased in release builds.

fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self

Calls .tap_mut() only in debug builds, and is erased in release builds. Read more

fn tap_borrow_dbg(self, func: impl FnOnce(&B)) -> Self where
Self: Borrow,
B: ?Sized,

Calls .tap_borrow() only in debug builds, and is erased in release builds. Read more

fn tap_borrow_mut_dbg(self, func: impl FnOnce(&mut B)) -> Self where
Self: BorrowMut,
B: ?Sized,

Calls .tap_borrow_mut() only in debug builds, and is erased in release builds. Read more

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self where
Self: AsRef<R>,
R: ?Sized,

Calls .tap_ref() only in debug builds, and is erased in release builds. Read more

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self where
Self: AsMut<R>,
R: ?Sized,

Calls .tap_ref_mut() only in debug builds, and is erased in release builds. Read more

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self where
Self: Deref<Target = T>,
T: ?Sized,

Calls .tap_deref() only in debug builds, and is erased in release builds. Read more

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Self where
Self: DerefMut<Target = T> + Deref,
T: ?Sized,

Calls .tap_deref_mut() only in debug builds, and is erased in release builds. Read more

source

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

source

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T> TryConv for T

fn try_conv<T>(self) -> Result<T, Self::Error> where
Self: TryInto<T>,

Attempts to convert self into T using TryInto<T>. Read more

source

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

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.

source

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

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.

Struct asn1_rs::Header

Implementations

impl<'a> Header<'a>

pub const fn new( class: Class, constructed: bool, tag: Tag, length: Length) -> Self

pub const fn new_simple(tag: Tag) -> Self

pub fn with_class(self, class: Class) -> Self

pub fn with_constructed(self, constructed: bool) -> Self

pub fn with_tag(self, tag: Tag) -> Self

pub fn with_length(self, length: Length) -> Self

pub fn with_raw_tag(self, raw_tag: Option<Cow<'a, [u8]>>) -> Self

pub const fn class(&self) -> Class

pub const fn constructed(&self) -> bool

pub const fn tag(&self) -> Tag

pub const fn length(&self) -> Length

pub fn raw_tag(&self) -> Option<&[u8]>

pub const fn is_primitive(&self) -> bool

pub const fn is_constructed(&self) -> bool

pub const fn assert_class(&self, class: Class) -> Result<()>

pub const fn assert_tag(&self, tag: Tag) -> Result<()>

pub const fn assert_primitive(&self) -> Result<()>

pub const fn assert_constructed(&self) -> Result<()>

pub const fn is_universal(&self) -> bool

pub const fn is_application(&self) -> bool

pub const fn is_contextspecific(&self) -> bool

pub const fn is_private(&self) -> bool

pub const fn assert_definite(&self) -> Result<()>

pub fn parse_ber_content<'i>(&self, i: &'i [u8]) -> ParseResult<'i, &'i [u8]>

pub fn parse_der_content<'i>(&self, i: &'i [u8]) -> ParseResult<'i, &'i [u8]>

Trait Implementations

impl<'a> Clone for Header<'a>

fn clone(&self) -> Header<'a>

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

impl<'a> Debug for Header<'a>

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

impl DynTagged for Header<'_>

fn tag(&self) -> Tag

impl From<Tag> for Header<'_>

fn from(tag: Tag) -> Self

impl<'a> FromBer<'a, Error> for Header<'a>

fn from_ber(bytes: &'a [u8]) -> ParseResult<'_, Self>

impl<'a> FromDer<'a, Error> for Header<'a>

fn from_der(bytes: &'a [u8]) -> ParseResult<'_, Self>

impl<'a> PartialEq<Header<'a>> for Header<'a>

fn eq(&self, other: &Header<'_>) -> bool

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

impl ToDer for Header<'_>

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

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

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

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

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

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

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

impl<'a> ToStatic for Header<'a>

type Owned = Header<'static>

fn to_static(&self) -> Self::Owned

impl Eq for Header<'_>

Auto Trait Implementations

impl<'a> RefUnwindSafe for Header<'a>

impl<'a> Send for Header<'a>

impl<'a> Sync for Header<'a>

impl<'a> Unpin for Header<'a>

impl<'a> UnwindSafe for Header<'a>

Blanket Implementations

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

fn type_id(&self) -> TypeId

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

fn borrow(&self) -> &T

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

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

impl<T> Conv for T

fn conv<T>(self) -> T where Self: Into<T>,

impl<T> FmtForward for T

fn fmt_binary(self) -> FmtBinary<Self> where Self: Binary,

fn fmt_display(self) -> FmtDisplay<Self> where Self: Display,

fn fmt_lower_exp(self) -> FmtLowerExp<Self> where Self: LowerExp,

fn fmt_lower_hex(self) -> FmtLowerHex<Self> where Self: LowerHex,

fn fmt_octal(self) -> FmtOctal<Self> where Self: Octal,

fn fmt_pointer(self) -> FmtPointer<Self> where Self: Pointer,

fn fmt_upper_exp(self) -> FmtUpperExp<Self> where Self: UpperExp,

pub const fn new(
class: Class,
constructed: bool,
tag: Tag,
length: Length
) -> Self

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

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

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

fn conv<T>(self) -> T where
Self: Into<T>,

fn fmt_binary(self) -> FmtBinary<Self> where
Self: Binary,

fn fmt_display(self) -> FmtDisplay<Self> where
Self: Display,

fn fmt_lower_exp(self) -> FmtLowerExp<Self> where
Self: LowerExp,

fn fmt_lower_hex(self) -> FmtLowerHex<Self> where
Self: LowerHex,

fn fmt_octal(self) -> FmtOctal<Self> where
Self: Octal,

fn fmt_pointer(self) -> FmtPointer<Self> where
Self: Pointer,

fn fmt_upper_exp(self) -> FmtUpperExp<Self> where
Self: UpperExp,

fn fmt_upper_hex(self) -> FmtUpperHex<Self> where
Self: UpperHex,

fn fmt_list(self) -> FmtList<Self> where
&'a Self: for<'a> IntoIterator,

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

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

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R where
R: 'a,

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R where
R: 'a,

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R where
Self: Borrow<B>,
B: 'a + ?Sized,
R: 'a,

fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R
) -> R where
Self: BorrowMut<B>,
B: 'a + ?Sized,
R: 'a,

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R where
Self: AsRef<U>,
U: 'a + ?Sized,
R: 'a,

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R where
Self: AsMut<U>,
U: 'a + ?Sized,
R: 'a,

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R where
Self: Deref<Target = T>,
T: 'a + ?Sized,
R: 'a,

fn pipe_deref_mut<'a, T, R>(
&'a mut self,
func: impl FnOnce(&'a mut T) -> R
) -> R where
Self: DerefMut<Target = T> + Deref,
T: 'a + ?Sized,
R: 'a,

fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self where
Self: Borrow<B>,
B: ?Sized,

fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self where
Self: BorrowMut<B>,
B: ?Sized,

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self where
Self: AsRef<R>,
R: ?Sized,

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self where
Self: AsMut<R>,
R: ?Sized,

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self where
Self: Deref<Target = T>,
T: ?Sized,

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self where
Self: DerefMut<Target = T> + Deref,
T: ?Sized,

fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self where
Self: Borrow<B>,
B: ?Sized,

fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self where
Self: BorrowMut<B>,
B: ?Sized,

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self where
Self: AsRef<R>,
R: ?Sized,

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self where
Self: AsMut<R>,
R: ?Sized,

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self where
Self: Deref<Target = T>,
T: ?Sized,

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Self where
Self: DerefMut<Target = T> + Deref,
T: ?Sized,

impl<T> ToOwned for T where
T: Clone,

fn try_conv<T>(self) -> Result<T, Self::Error> where
Self: TryInto<T>,

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

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