Struct cbor_data::Cbor

pub struct Cbor<'a>(_);

Wrapper around a byte slice that allows parsing as CBOR value.

For details on the format see RFC 7049.

When interpreting CBOR messages from the outside (e.g. from the network) it is advisable to ingest those using the CborOwned::canonical constructor. In case the message was encoded for example using CborBuilder it is sufficient to use the trusting constructor.

Implementations

impl<'a> Cbor<'a>

pub fn trusting(bytes: &'a [u8]) -> Self

Wrap in Cbor for indexing.

No checks on the integrity are made, indexing methods may panic if encoded lengths are out of bound or when encountering indefinite size (byte) strings. If you want to carefully treat data obtained from unreliable sources, prefer CborOwned::canonical. The results of CborBuilder can also safely be fed to this method.

pub fn to_owned(&self) -> CborOwned

Copy the underlying bytes to create a fully owned CBOR value.

No checks on the integrity are made, indexing methods may panic if encoded lengths are out of bound or when encountering indefinite size (byte) strings. If you want to carefully treat data obtained from unreliable sources, prefer CborOwned::canonical. The results of CborBuilder can also safely be fed to this method.

impl<'a> Cbor<'a>

pub fn as_slice(&self) -> &'a [u8]

A view onto the underlying bytes

pub fn value(&self) -> Option<CborValue<'a>>

Extract the single value represented by this piece of CBOR

pub fn index(&self, path: &str) -> Option<CborValue<'a>>

Extract a value by indexing into arrays and dicts, with path elements separated by dot.

The empty string will yield the same as calling value(). If path elements may contain . then use index_iter().

pub fn index_iter<'b>(
    &self,
    path: impl IntoIterator<Item = &'b str>
) -> Option<CborValue<'a>>

Extract a value by indexing into arrays and dicts, with path elements yielded by an iterator.

The empty iterator will yield the same as calling value().

pub fn is_array(&self) -> bool

Check if this CBOR contains an array as its top-level item. Returns false also in case of data format problems.

pub fn is_dict(&self) -> bool

Check if this CBOR contains an dict as its top-level item. Returns false also in case of data format problems.

Trait Implementations

impl<'a> AsRef<[u8]> for Cbor<'a>

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

Performs the conversion.

impl<'a> Debug for Cbor<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq<Cbor<'a>> for Cbor<'a>

pub fn eq(&self, other: &Cbor<'a>) -> bool

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

pub fn ne(&self, other: &Cbor<'a>) -> bool

This method tests for !=.

impl<'a> StructuralPartialEq for Cbor<'a>