Struct IndefiniteLength

pub struct IndefiniteLength(/* private fields */);

Length type with support for indefinite lengths as used by ASN.1 BER, as described in X.690 Section 8.1.3.6:

8.1.3.6 For the indefinite form, the length octets indicate that the contents octets are terminated by end-of-contents octets (see 8.1.5), and shall consist of a single octet.

8.1.3.6.1 The single octet shall have bit 8 set to one, and bits 7 to 1 set to zero.

8.1.3.6.2 If this form of length is used, then end-of-contents octets (see 8.1.5) shall be present in the encoding following the contents octets.

Indefinite lengths are non-canonical and therefore invalid DER, however there are interoperability corner cases where we have little choice but to tolerate some BER productions where this is helpful.

Implementations

impl IndefiniteLength

pub const ZERO: Self = _

Length of 0.

pub const ONE: Self = _

Length of 1.

pub const INDEFINITE: Self = _

Indefinite length.

impl IndefiniteLength

pub fn new(length: impl Into<Length>) -> Self

Create a definite length from a type which can be converted into a Length.

pub fn is_definite(self) -> bool

Is this length definite?

pub fn is_indefinite(self) -> bool

Is this length indefinite?

Trait Implementations

impl Clone for IndefiniteLength

fn clone(&self) -> IndefiniteLength

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for IndefiniteLength

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

Formats the value using the given formatter.

impl<'a> Decode<'a> for IndefiniteLength

fn decode<R: Reader<'a>>(reader: &mut R) -> Result<IndefiniteLength>

Attempt to decode this message using the provided decoder.

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

Parse Self from the provided DER-encoded byte slice.

impl Encode for IndefiniteLength

fn encoded_len(&self) -> Result<Length>

Compute the length of this value in bytes when encoded as ASN.1 DER.

fn encode(&self, writer: &mut impl Writer) -> Result<()>

Encode this value as ASN.1 DER using the provided Writer.

fn encode_to_slice<'a>(&self, buf: &'a mut [u8]) -> Result<&'a [u8]>

Encode this value to the provided byte slice, returning a sub-slice containing the encoded message.

fn encode_to_vec(&self, buf: &mut Vec<u8>) -> Result<Length>

Encode this message as ASN.1 DER, appending it to the provided byte vector.

fn to_der(&self) -> Result<Vec<u8>>

Encode this type as DER, returning a byte vector.

impl From<IndefiniteLength> for Option<Length>

fn from(length: IndefiniteLength) -> Option<Length>

Converts to this type from the input type.

impl From<Length> for IndefiniteLength

fn from(length: Length) -> IndefiniteLength

Converts to this type from the input type.

impl From<Option<Length>> for IndefiniteLength

fn from(length: Option<Length>) -> IndefiniteLength

Converts to this type from the input type.

impl Ord for IndefiniteLength

fn cmp(&self, other: &IndefiniteLength) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for IndefiniteLength

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for IndefiniteLength

fn partial_cmp(&self, other: &IndefiniteLength) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl TryFrom<IndefiniteLength> for Length

type Error = Error

The type returned in the event of a conversion error.

fn try_from(length: IndefiniteLength) -> Result<Length>

Performs the conversion.

impl Copy for IndefiniteLength

impl Eq for IndefiniteLength

impl StructuralPartialEq for IndefiniteLength