rkyv 0.8.16

Zero-copy deserialization framework for Rust
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

use rancor::Fallible;
use thin_vec_0_2::ThinVec;

use crate::{
    ser::{Allocator, Writer},
    vec::{ArchivedVec, VecResolver},
    Archive, Archived, Deserialize, Place, Serialize,
};

impl<T> Archive for ThinVec<T>
where
    T: Archive,
{
    type Archived = ArchivedVec<Archived<T>>;
    type Resolver = VecResolver;

    fn resolve(&self, resolver: Self::Resolver, out: Place<Self::Archived>) {
        ArchivedVec::resolve_from_slice(self.as_slice(), resolver, out);
    }
}

impl<T, S> Serialize<S> for ThinVec<T>
where
    T: Serialize<S>,
    S: Allocator + Writer + Fallible + ?Sized,
{
    fn serialize(
        &self,
        serializer: &mut S,
    ) -> Result<Self::Resolver, S::Error> {
        ArchivedVec::serialize_from_slice(self.as_slice(), serializer)
    }
}

impl<T, D: Fallible + ?Sized> Deserialize<ThinVec<T>, D>
    for ArchivedVec<Archived<T>>
where
    T: Archive,
    Archived<T>: Deserialize<T, D>,
{
    fn deserialize(
        &self,
        deserializer: &mut D,
    ) -> Result<ThinVec<T>, D::Error> {
        let mut result = ThinVec::with_capacity(self.len());
        for item in self.as_slice() {
            result.push(item.deserialize(deserializer)?);
        }
        Ok(result)
    }
}

impl<T, U> PartialEq<ThinVec<U>> for ArchivedVec<T>
where
    T: PartialEq<U>,
{
    fn eq(&self, other: &ThinVec<U>) -> bool {
        self.as_slice().eq(other.as_slice())
    }
}

impl<T, U> PartialOrd<ThinVec<U>> for ArchivedVec<T>
where
    T: PartialOrd<U>,
{
    fn partial_cmp(&self, other: &ThinVec<U>) -> Option<::core::cmp::Ordering> {
        crate::impls::lexicographical_partial_ord(
            self.as_slice(),
            other.as_slice(),
        )
    }
}

#[cfg(test)]
mod tests {
    use super::ThinVec;
    use crate::api::test::roundtrip_with;

    #[test]
    fn roundtrip_thin_vec() {
        roundtrip_with(&ThinVec::<i32>::from_iter([10, 20, 40, 80]), |a, b| {
            assert_eq!(**a, **b)
        });
    }

    #[test]
    fn test_partial_eq() {
        use crate::Archive;

        #[allow(unused)]
        #[derive(Archive)]
        #[rkyv(crate, compare(PartialEq, PartialOrd))]
        struct Inner {
            a: i32,
        }

        #[allow(unused)]
        #[derive(Archive)]
        #[rkyv(crate, compare(PartialEq, PartialOrd))]
        struct Outer {
            a: ThinVec<Inner>,
        }
    }
}