le-stream 10.1.4

De-/serialize objects from/to little endian byte streams
Documentation
#![cfg(feature = "heapless")]

//! Deserialization for length-prefixed heapless collections.
//!
//! `heapless::Vec<T, N, LenT>` reads a little-endian `LenT` element count and
//! then attempts to deserialize exactly that many `T` values. `heapless::String`
//! follows the same rule with a byte count and validates the consumed bytes as
//! UTF-8. The fixed capacity encoded in the type makes the prefixed format
//! appropriate for these collections.

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

use crate::FromLeStream;

impl<T, const SIZE: usize, LenT> FromLeStream for Vec<T, SIZE, LenT>
where
    T: FromLeStream,
    LenT: LenType + FromLeStream + Into<usize>,
{
    fn from_le_stream<I>(mut bytes: I) -> Option<Self>
    where
        I: Iterator<Item = u8>,
    {
        let size: usize = LenT::from_le_stream(bytes.by_ref())?.into();
        let mut result = Self::new();

        for _ in 0..size {
            result
                .push(T::from_le_stream(bytes.by_ref())?)
                .unwrap_or_else(drop);
        }

        Some(result)
    }
}

impl<const SIZE: usize, LenT> FromLeStream for String<SIZE, LenT>
where
    LenT: LenType + FromLeStream + Into<usize>,
{
    fn from_le_stream<T>(mut bytes: T) -> Option<Self>
    where
        T: Iterator<Item = u8>,
    {
        Vec::from_le_stream(&mut bytes).and_then(|vec| Self::from_utf8(vec).ok())
    }
}