nbt-rs 0.5.0

A simple rust library for dealing with NBT
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
54
55
56
57
58
59
60
61
62
63
64
65

/// Mostly for readability, allows getting the nbt tag payload from types that implement it.
/// It is used internally, most likely you should not implement or use it yourself.
pub trait NbtSerialize {
    /// Serializes the nbt payload of `self` extending the buffer.
    ///
    /// # Examples
    /// ```
    /// use nbt_rs::traits::NbtSerialize;
    /// struct Example { value: i32 }
    /// impl NbtSerialize for Example {
    ///     fn serialize_nbt_payload(&self, buf: &mut Vec<u8>) {
    ///         buf.extend(&self.value.to_be_bytes());
    ///     }
    /// }
    ///
    /// let mut buffer = Vec::new();
    /// Example { value: 0 }.serialize_nbt_payload(&mut buffer);
    /// assert_eq!(buffer.len(), 4);
    /// ```
    fn serialize_nbt_payload(&self, buf: &mut Vec<u8>);
}

impl NbtSerialize for i8 {
    #[inline(always)]
    fn serialize_nbt_payload(&self, buf: &mut Vec<u8>) {
        (*self as u8).serialize_nbt_payload(buf);
    }
}

impl NbtSerialize for u8 {
    fn serialize_nbt_payload(&self, buf: &mut Vec<u8>) {
        buf.push(*self);
    }
}

macro_rules! impl_nbt_serialize_numeric {
    ($ty:ty) => {
        impl NbtSerialize for $ty {
            fn serialize_nbt_payload(&self, buf: &mut Vec<u8>) {
                buf.extend_from_slice(&self.to_be_bytes());
            }
        }
    };
}

// a bit better cache efficiency that way
macro_rules! impl_nbt_serialize_numeric_cast {
    ($ty:ty, $from:ty) => {
        impl NbtSerialize for $ty {
            #[inline(always)]
            fn serialize_nbt_payload(&self, buf: &mut Vec<u8>) {
                (*self as $from).serialize_nbt_payload(buf)
            }
        }
    };
}

impl_nbt_serialize_numeric!(i16);
impl_nbt_serialize_numeric_cast!(u16, i16);
impl_nbt_serialize_numeric!(i32);
impl_nbt_serialize_numeric_cast!(u32, i32);
impl_nbt_serialize_numeric!(i64);
impl_nbt_serialize_numeric_cast!(u64, i64);
impl_nbt_serialize_numeric!(f32);
impl_nbt_serialize_numeric!(f64);