Struct OctetString

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

ASN.1 OCTETSTRING type

This objects implements Copy-On-Write over data:

• when parsing primitive form, parser will return a shared object
• when parsing primitive form, parser must allocate memory

This type supports constructed objects, but all data segments are appended during parsing (i.e object structure is not kept after parsing).

Implementations

impl<'a> OctetString<'a>

pub const fn new(s: &'a [u8]) -> Self

pub fn as_cow(&'a self) -> &'a Cow<'a, [u8]>

Get the bytes representation of the content

pub fn into_cow(self) -> Cow<'a, [u8]>

Get the bytes representation of the content

Trait Implementations

impl Appendable for OctetString<'_>

fn append(&mut self, other: &mut Self)

impl AsRef<[u8]> for OctetString<'_>

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

Converts this type into a shared reference of the (usually inferred) input type.

impl<'i> BerParser<'i> for OctetString<'i>

type Error = BerError<Input<'i>>

The Error type for parsing errors.

fn from_ber_content( header: &Header<'i>, input: Input<'i>, ) -> IResult<Input<'i>, Self, Self::Error>

Parse a new BER object from header and data.

fn parse_ber(input: Input<'i>) -> IResult<Input<'i>, Self, Self::Error>

Attempt to parse a new BER object from data.

fn parse_ber_optional( input: Input<'i>, ) -> IResult<Input<'i>, Option<Self>, Self::Error>

fn parse_ber_as_input( input: Input<'i>, ) -> IResult<Input<'i>, (Header<'i>, Input<'i>), Self::Error>

Parse object header (validating tag) and return header and content as Input

impl CheckDerConstraints for OctetString<'_>

fn check_constraints(any: &Any<'_>) -> Result<()>

impl<'a> Debug for OctetString<'a>

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

Formats the value using the given formatter.

impl<'a> Default for OctetString<'a>

fn default() -> OctetString<'a>

Returns the “default value” for a type.

impl<'i> DerParser<'i> for OctetString<'i>

type Error = BerError<Input<'i>>

The Error type for parsing errors.

fn from_der_content( header: &Header<'i>, input: Input<'i>, ) -> IResult<Input<'i>, Self, Self::Error>

Parse a new DER object from header and data.

fn parse_der(input: Input<'i>) -> IResult<Input<'i>, Self, Self::Error>

Attempt to parse a new DER object from data.

fn parse_der_optional( input: Input<'i>, ) -> IResult<Input<'i>, Option<Self>, Self::Error>

fn parse_der_as_input( input: Input<'i>, ) -> IResult<Input<'i>, (Header<'i>, Input<'i>), Self::Error>

Parse object header (validating tag) and return header and content as Input

impl<'a> From<&'a [u8]> for OctetString<'a>

fn from(b: &'a [u8]) -> Self

Converts to this type from the input type.

impl<'a> PartialEq for OctetString<'a>

fn eq(&self, other: &OctetString<'a>) -> 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 Tagged for OctetString<'_>

const TAG: Tag = Tag::OctetString

const CLASS: Class = Class::Universal

const CONSTRUCTED: bool = false

impl ToBer for OctetString<'_>

type Encoder = Primitive<{ Tag::OctetString.0 }>

fn ber_content_len(&self) -> Length

Returns the length of the encoded content of the object

fn ber_write_content<W: Write>(&self, target: &mut W) -> SerializeResult<usize>

Encode and write the content of the object to the writer target

fn ber_tag_info(&self) -> (Class, bool, Tag)

Return the tag information to be encoded in header

fn ber_total_len(&self) -> Length

Returns the total length (including header) of the encoded content of the object

fn ber_write_header<W: Write>(&self, target: &mut W) -> SerializeResult<usize>

Encode and write the header of the object to the writer target

fn ber_encode<W: Write>(&self, target: &mut W) -> SerializeResult<usize>

Encode and write the object (header + content) to the writer target

fn ber_encode_tagged_explicit<W: Write>( &self, class: Class, tag_number: u32, target: &mut W, ) -> SerializeResult<usize>

Encode and write the object (header + content) as TAGGED EXPLICIT and write it to the writer target

fn ber_encode_tagged_implicit<W: Write>( &self, class: Class, tag_number: u32, target: &mut W, ) -> SerializeResult<usize>

Encode and write the object (header + content) as TAGGED IMPLICIT and write it to the writer target

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

Write the DER encoded representation to a newly allocated Vec<u8>

fn write_ber<W: Write>(&self, writer: &mut W) -> SerializeResult<usize>

Encode in BER and write the object (header + content) to the writer target

impl<'a> ToDer for OctetString<'a>

where OctetString<'a>: ToBer,

type Encoder = <OctetString<'a> as ToBer>::Encoder

fn der_content_len(&self) -> Length

Returns the length of the encoded content of the object

fn der_tag_info(&self) -> (Class, bool, Tag)

Return the tag information to be encoded in header

fn der_write_content<W: Write>(&self, target: &mut W) -> SerializeResult<usize>

Encode and write the content of the object to the writer target

fn der_total_len(&self) -> Length

Returns the total length (including header) of the encoded content of the object

fn der_write_header<W: Write>(&self, target: &mut W) -> SerializeResult<usize>

Encode and write the header of the object to the writer target

fn der_encode<W: Write>(&self, target: &mut W) -> SerializeResult<usize>

Encode and write the object (header + content) to the writer target

fn der_encode_tagged_explicit<W: Write>( &self, class: Class, tag_number: u32, target: &mut W, ) -> SerializeResult<usize>

Encode and write the object (header + content) as TAGGED EXPLICIT and write it to the writer target

fn der_encode_tagged_implicit<W: Write>( &self, class: Class, tag_number: u32, target: &mut W, ) -> SerializeResult<usize>

Encode and write the object (header + content) as TAGGED IMPLICIT and write it to the writer target

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

Write the DER encoded representation to a newly allocated Vec<u8>

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

Encode in DER and write the object (header + content) to the writer target

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

👎Deprecated since 0.8.0: Use der_total_len() instead.

Get the length of the object (including the header), when encoded

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

👎Deprecated since 0.8.0: Use to_der_vec() instead.

impl<'i, 'b> TryFrom<&'b Any<'i>> for OctetString<'i>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: &'b Any<'i>) -> Result<Self>

Performs the conversion.

impl<'i> TryFrom<Any<'i>> for OctetString<'i>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'i>) -> Result<Self>

Performs the conversion.

impl DerAutoDerive for OctetString<'_>

impl<'a> Eq for OctetString<'a>

impl<'a> StructuralPartialEq for OctetString<'a>