Struct der::asn1::BitStringRef
source · [−]pub struct BitStringRef<'a> { /* private fields */ }
Expand description
ASN.1 BIT STRING
type.
This type contains a sequence of any number of bits, modeled internally as a sequence of bytes with a known number of “unused bits”.
This is a zero-copy reference type which borrows from the input data.
Implementations
sourceimpl<'a> BitStringRef<'a>
impl<'a> BitStringRef<'a>
sourcepub const MAX_UNUSED_BITS: u8 = 7u8
pub const MAX_UNUSED_BITS: u8 = 7u8
Maximum number of unused bits allowed.
sourcepub fn new(unused_bits: u8, bytes: &'a [u8]) -> Result<Self>
pub fn new(unused_bits: u8, bytes: &'a [u8]) -> Result<Self>
Create a new ASN.1 BIT STRING
from a byte slice.
Accepts an optional number of “unused bits” (0-7) which are omitted from the final octet. This number is 0 if the value is octet-aligned.
sourcepub fn from_bytes(bytes: &'a [u8]) -> Result<Self>
pub fn from_bytes(bytes: &'a [u8]) -> Result<Self>
Create a new ASN.1 BIT STRING
from the given bytes.
The “unused bits” are set to 0.
sourcepub fn unused_bits(&self) -> u8
pub fn unused_bits(&self) -> u8
Get the number of unused bits in this byte slice.
sourcepub fn has_unused_bits(&self) -> bool
pub fn has_unused_bits(&self) -> bool
Is the number of unused bits a value other than 0?
sourcepub fn byte_len(&self) -> Length
pub fn byte_len(&self) -> Length
Get the number of bytes/octets needed to represent this BIT STRING
when serialized in an octet-aligned manner.
sourcepub fn as_bytes(&self) -> Option<&'a [u8]>
pub fn as_bytes(&self) -> Option<&'a [u8]>
Borrow the inner byte slice.
Returns None
if the number of unused bits is not equal to zero,
i.e. if the BIT STRING
is not octet aligned.
Use BitString::raw_bytes
to obtain access to the raw value
regardless of the presence of unused bits.
sourcepub fn raw_bytes(&self) -> &'a [u8]ⓘNotable traits for &'_ [u8]impl<'_> Read for &'_ [u8]impl<'_> Write for &'_ mut [u8]
pub fn raw_bytes(&self) -> &'a [u8]ⓘNotable traits for &'_ [u8]impl<'_> Read for &'_ [u8]impl<'_> Write for &'_ mut [u8]
Borrow the raw bytes of this BIT STRING
.
Note that the byte string may contain extra unused bits in the final
octet. If the number of unused bits is expected to be 0, the
BitStringRef::as_bytes
function can be used instead.
sourcepub fn bits(self) -> BitStringIter<'a>ⓘNotable traits for BitStringIter<'a>impl<'a> Iterator for BitStringIter<'a> type Item = bool;
pub fn bits(self) -> BitStringIter<'a>ⓘNotable traits for BitStringIter<'a>impl<'a> Iterator for BitStringIter<'a> type Item = bool;
Iterator over the bits of this BIT STRING
.
Trait Implementations
sourceimpl<'a> Clone for BitStringRef<'a>
impl<'a> Clone for BitStringRef<'a>
sourcefn clone(&self) -> BitStringRef<'a>
fn clone(&self) -> BitStringRef<'a>
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
sourceimpl<'a> Debug for BitStringRef<'a>
impl<'a> Debug for BitStringRef<'a>
sourceimpl<'a> DecodeValue<'a> for BitStringRef<'a>
impl<'a> DecodeValue<'a> for BitStringRef<'a>
sourceimpl EncodeValue for BitStringRef<'_>
impl EncodeValue for BitStringRef<'_>
sourceimpl<'a> From<&'_ BitStringRef<'a>> for BitStringRef<'a>
impl<'a> From<&'_ BitStringRef<'a>> for BitStringRef<'a>
sourcefn from(value: &BitStringRef<'a>) -> BitStringRef<'a>
fn from(value: &BitStringRef<'a>) -> BitStringRef<'a>
Converts to this type from the input type.
sourceimpl<'a> From<&'a BitString> for BitStringRef<'a>
impl<'a> From<&'a BitString> for BitStringRef<'a>
sourcefn from(bit_string: &'a BitString) -> BitStringRef<'a>
fn from(bit_string: &'a BitString) -> BitStringRef<'a>
Converts to this type from the input type.
sourceimpl<'a> Ord for BitStringRef<'a>
impl<'a> Ord for BitStringRef<'a>
sourceimpl<'a> PartialEq<BitStringRef<'a>> for BitStringRef<'a>
impl<'a> PartialEq<BitStringRef<'a>> for BitStringRef<'a>
sourcefn eq(&self, other: &BitStringRef<'a>) -> bool
fn eq(&self, other: &BitStringRef<'a>) -> bool
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
sourcefn ne(&self, other: &BitStringRef<'a>) -> bool
fn ne(&self, other: &BitStringRef<'a>) -> bool
This method tests for !=
.
sourceimpl<'a> PartialOrd<BitStringRef<'a>> for BitStringRef<'a>
impl<'a> PartialOrd<BitStringRef<'a>> for BitStringRef<'a>
sourcefn partial_cmp(&self, other: &BitStringRef<'a>) -> Option<Ordering>
fn partial_cmp(&self, other: &BitStringRef<'a>) -> Option<Ordering>
This method returns an ordering between self
and other
values if one exists. Read more
1.0.0 · sourcefn lt(&self, other: &Rhs) -> bool
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self
and other
) and is used by the <
operator. Read more
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
sourceimpl<'a> TryFrom<&'_ &'a [u8]> for BitStringRef<'a>
impl<'a> TryFrom<&'_ &'a [u8]> for BitStringRef<'a>
Hack for simplifying the custom derive use case.
sourceimpl<'a> TryFrom<AnyRef<'a>> for BitStringRef<'a>
impl<'a> TryFrom<AnyRef<'a>> for BitStringRef<'a>
sourceimpl ValueOrd for BitStringRef<'_>
impl ValueOrd for BitStringRef<'_>
impl<'a> Copy for BitStringRef<'a>
impl<'a> Eq for BitStringRef<'a>
impl<'a> StructuralEq for BitStringRef<'a>
impl<'a> StructuralPartialEq for BitStringRef<'a>
Auto Trait Implementations
impl<'a> RefUnwindSafe for BitStringRef<'a>
impl<'a> Send for BitStringRef<'a>
impl<'a> Sync for BitStringRef<'a>
impl<'a> Unpin for BitStringRef<'a>
impl<'a> UnwindSafe for BitStringRef<'a>
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more