speedy 0.8.7

A fast binary serialization framework
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

use {
    crate::{
        Readable,
        Reader,
        Context
    }
};

impl< 'a, C: Context > Readable< 'a, C > for &'a str {
    #[inline]
    fn read_from< R: Reader< 'a, C > >( reader: &mut R ) -> Result< Self, C::Error > {
        let length = crate::private::read_length( reader )?;
        let bytes = reader.read_bytes_borrowed( length ).ok_or_else( crate::error::error_unsized )??;
        let value = std::str::from_utf8( bytes ).map_err( crate::error::error_invalid_str_utf8 )?;
        Ok( value )
    }

    #[inline]
    fn minimum_bytes_needed() -> usize {
        <String as Readable< 'a, C >>::minimum_bytes_needed()
    }
}

impl< 'a, C: Context, T > Readable< 'a, C > for &'a [T] where T: crate::utils::ZeroCopyable< C, T > {
    #[inline]
    fn read_from< R: Reader< 'a, C > >( reader: &mut R ) -> Result< Self, C::Error > {
        if std::mem::size_of::< T >() != 1 && reader.endianness().conversion_necessary() {
            return Err( crate::error::error_endianness_mismatch() );
        }

        let length = crate::private::read_length( reader )?;
        let bytelength = length.checked_mul( std::mem::size_of::< T >() ).ok_or_else( crate::error::error_out_of_range_length )?;
        let bytes = reader.read_bytes_borrowed( bytelength ).ok_or_else( crate::error::error_unsized )??;
        let slice = unsafe {
            std::slice::from_raw_parts( bytes.as_ptr() as *const T, length )
        };
        Ok( slice )
    }

    #[inline]
    fn minimum_bytes_needed() -> usize {
        4
    }
}

#[inline(always)]
unsafe fn cast_slice< T, const N: usize >( slice: &[u8] ) -> &[T; N] {
    unsafe {
        &*(slice.as_ptr() as *const [T; N])
    }
}

impl< 'a, C: Context, T, const N: usize > Readable< 'a, C > for &'a [T; N] where T: crate::utils::ZeroCopyable< C, T > {
    #[inline]
    fn read_from< R: Reader< 'a, C > >( reader: &mut R ) -> Result< Self, C::Error > {
        if std::mem::size_of::< T >() != 1 && reader.endianness().conversion_necessary() {
            return Err( crate::error::error_endianness_mismatch() );
        }

        let bytes = reader.read_bytes_borrowed( std::mem::size_of::< T >() * N ).ok_or_else( crate::error::error_unsized )??;
        let slice = unsafe { cast_slice( bytes ) };
        Ok( slice )
    }

    #[inline]
    fn minimum_bytes_needed() -> usize {
        std::mem::size_of::< T >() * N
    }
}