Skip to main content

StringTypeMode

Enum StringTypeMode 

Source
pub enum StringTypeMode {
    Owned,
    Borrowed,
}
Expand description

Controls whether string and binary ASN.1 types are generated as owned heap-allocating types or as zero-copy borrowed references.

The following ASN.1 types have both an owned form and a zero-copy Ref variant and are therefore affected by this setting:

ASN.1 typeOwned (Owned mode)Borrowed (Borrowed mode)
OCTET STRINGOctetStringOctetStringRef<'a>
BIT STRINGBitStringBitStringRef<'a>
UTF8StringUtf8StringUtf8StringRef<'a>
PrintableStringPrintableStringPrintableStringRef<'a>
IA5StringIA5StringIA5StringRef<'a>

Types that have no zero-copy variant (TeletexString, BmpString, UniversalString, GeneralString, NumericString, VisibleString) are always emitted as owned types regardless of this setting.

Named bit strings (BIT STRING { flag(0), … }) are always emitted as owned BitString regardless of this setting because they are decoded into a concrete bit-field type.

  • StringTypeMode::Owned (default): heap-allocates on decode; convenient for constructing structs from scratch (e.g. in tests or protocol message builders).
  • StringTypeMode::Borrowed: borrows directly from the input buffer; optimal for parse-only workloads such as X.509 certificate inspection. Every struct that contains these fields (directly or transitively) gains a 'a lifetime parameter.

Variants§

§

Owned

Generate owned, heap-allocating types (OctetString, BitString, …). No lifetime parameter is added to generated structs.

§

Borrowed

Generate zero-copy borrowed types (OctetStringRef<'a>, BitStringRef<'a>, …) that borrow from the decoder’s input buffer. Structs containing these fields acquire a 'a lifetime parameter.

Trait Implementations§

Source§

impl Clone for StringTypeMode

Source§

fn clone(&self) -> StringTypeMode

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for StringTypeMode

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for StringTypeMode

Source§

fn default() -> StringTypeMode

Returns the “default value” for a type. Read more
Source§

impl Eq for StringTypeMode

Source§

impl PartialEq for StringTypeMode

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

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

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

impl StructuralPartialEq for StringTypeMode

Auto Trait Implementations§

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,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

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

Source§

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

Mutably borrows from an owned value. Read more
Source§

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

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

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

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.

Source§

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

Source§

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
Source§

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

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

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

Performs the conversion.
Source§

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

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

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

Performs the conversion.