le-stream 10.1.4

De-/serialize objects from/to little endian byte streams
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

#![cfg(feature = "heapless")]

//! Serialization for length-prefixed heapless collections.
//!
//! `heapless::Vec<T, N, LenT>` writes its element count as little-endian
//! `LenT`, followed by each element. `heapless::String<N, LenT>` writes its byte
//! length as `LenT`, followed by the UTF-8 bytes.

use core::iter::{Chain, FlatMap};

use heapless::{LenType, String, Vec};

use crate::ToLeStream;

impl<T, const SIZE: usize, LenT> ToLeStream for Vec<T, SIZE, LenT>
where
    T: ToLeStream,
    LenT: LenType + TryFrom<usize> + ToLeStream,
{
    type Iter = Chain<
        <LenT as ToLeStream>::Iter,
        FlatMap<
            <Self as IntoIterator>::IntoIter,
            <T as ToLeStream>::Iter,
            fn(T) -> <T as ToLeStream>::Iter,
        >,
    >;

    fn to_le_stream(self) -> Self::Iter {
        let len: LenT = self
            .len()
            .try_into()
            .unwrap_or_else(|_| unreachable!("Size cannot exceed LenT::MAX"));
        #[expect(trivial_casts)]
        len.to_le_stream()
            .chain(self.into_iter().flat_map(ToLeStream::to_le_stream as _))
    }
}

impl<const SIZE: usize, LenT> ToLeStream for String<SIZE, LenT>
where
    LenT: LenType + TryFrom<usize> + ToLeStream,
{
    type Iter = <Vec<u8, SIZE, LenT> as ToLeStream>::Iter;

    fn to_le_stream(self) -> Self::Iter {
        self.into_bytes().to_le_stream()
    }
}