pub struct ByteSerializer<'a> { /* private fields */ }Expand description
A serializer that writes data to a byte buffer in little-endian format.
This is a concrete implementation of the Serializer trait that writes
binary data in a compact, little-endian format. This is the default serializer
used by the crate::to_bytes convenience function.
§Format
- All integers are written in little-endian byte order
- Floating-point numbers use IEEE 754 representation
boolis written as a single byte (0 or 1)Option<T>: 1 byte tag (0=None, 1=Some) followed by T if Some- Arrays: Elements serialized sequentially (no length prefix)
- Tuples: Elements serialized sequentially
- Strings/Vec: u32 length prefix followed by data
§Examples
§Basic Usage
ⓘ
use osal_rs_serde::{ByteSerializer, Serializer, Serialize};
let mut buffer = [0u8; 16];
let mut serializer = ByteSerializer::new(&mut buffer);
serializer.serialize_u32("", 42).unwrap();
serializer.serialize_bool("", true).unwrap();
serializer.serialize_i16("", -100).unwrap();
let len = serializer.position();
println!("Serialized {} bytes", len);§With Structs
ⓘ
use osal_rs_serde::{ByteSerializer, Serialize};
#[derive(Serialize)]
struct Message {
id: u32,
value: i16,
}
let msg = Message { id: 100, value: -50 };
let mut buffer = [0u8; 32];
let mut serializer = ByteSerializer::new(&mut buffer);
msg.serialize(&mut serializer).unwrap();§Memory Layout
The serializer writes data sequentially without padding or alignment:
struct Data { a: u16, b: u32 }
Memory: [a_lo, a_hi, b0, b1, b2, b3]Implementations§
Trait Implementations§
Source§impl<'a> Serializer for ByteSerializer<'a>
impl<'a> Serializer for ByteSerializer<'a>
Source§fn serialize_array<T>(&mut self, name: &str, v: &[T]) -> Result<(), Self::Error>where
T: Serialize,
fn serialize_array<T>(&mut self, name: &str, v: &[T]) -> Result<(), Self::Error>where
T: Serialize,
Serialize an array of serializable items.
Source§fn serialize_string(
&mut self,
name: &str,
v: &String,
) -> Result<(), Self::Error>
fn serialize_string( &mut self, name: &str, v: &String, ) -> Result<(), Self::Error>
Serialize a string.
Source§fn serialize_str(&mut self, name: &str, v: &str) -> Result<(), Self::Error>
fn serialize_str(&mut self, name: &str, v: &str) -> Result<(), Self::Error>
Serialize a string slice.
Source§fn serialize_vec<T>(
&mut self,
name: &str,
v: &Vec<T>,
) -> Result<(), Self::Error>where
T: Serialize,
fn serialize_vec<T>(
&mut self,
name: &str,
v: &Vec<T>,
) -> Result<(), Self::Error>where
T: Serialize,
Serialize a vector of serializable items.
Source§fn serialize_struct_start(
&mut self,
_name: &str,
_len: usize,
) -> Result<(), Self::Error>
fn serialize_struct_start( &mut self, _name: &str, _len: usize, ) -> Result<(), Self::Error>
Begin serializing a struct with the given name and number of fields.
Default implementation does nothing (suitable for binary formats).
Auto Trait Implementations§
impl<'a> Freeze for ByteSerializer<'a>
impl<'a> RefUnwindSafe for ByteSerializer<'a>
impl<'a> Send for ByteSerializer<'a>
impl<'a> Sync for ByteSerializer<'a>
impl<'a> Unpin for ByteSerializer<'a>
impl<'a> UnsafeUnpin for ByteSerializer<'a>
impl<'a> !UnwindSafe for ByteSerializer<'a>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more