seabored 0.0.11

Implementation of the CBOR data format. Implements RFC8949 with the preferred-plus recommendations
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

use crate::ib::InitialByte;

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, PartialOrd, Ord)]
#[repr(u8)]
/// CBOR Major Type
pub enum MajorType {
    Uint = 0,
    NegativeUint = 1,
    Bytes = 2,
    String = 3,
    Array = 4,
    Map = 5,
    Tagged = 6,
    SimpleValueOrFloat = 7,
}

impl std::fmt::Display for MajorType {
    #[inline(always)]
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            MajorType::Uint => write!(f, "MajorType::Uint"),
            MajorType::NegativeUint => write!(f, "MajorType::NegativeUint"),
            MajorType::Bytes => write!(f, "MajorType::Bytes"),
            MajorType::String => write!(f, "MajorType::String"),
            MajorType::Array => write!(f, "MajorType::Array"),
            MajorType::Map => write!(f, "MajorType::Map"),
            MajorType::Tagged => write!(f, "MajorType::Tagged"),
            MajorType::SimpleValueOrFloat => write!(f, "MajorType::SimpleValueOrFloat"),
        }
    }
}

impl From<InitialByte> for MajorType {
    #[inline(always)]
    fn from(ib: InitialByte) -> Self {
        // SAFETY: u8::MAX >> 5 results in 7.
        // And MajorType goes from 0 to 7
        // so it's impossible for this to be UB
        unsafe { std::mem::transmute(ib.0 >> 5u8) }
    }
}

impl From<&crate::types::CborInteger> for MajorType {
    #[inline(always)]
    fn from(value: &crate::types::CborInteger) -> Self {
        // SAFETY: `negative` is a `bool` flag, and conveniently,
        // Major types 0 and 1 match to positive and negative ints respectively
        // Hence this transmute is always safe because:
        // - when `negative` is true, we end up with the `1u8` value, matching the MajorType::NegativeUint discriminant
        // - when `negative` is false, we end up with the `0u8` value, matching the MajorType::Uint discriminant
        unsafe { std::mem::transmute(value.negative as u8) }
    }
}