Struct FieldEncoder 

pub struct FieldEncoder { /* private fields */ }

A sequential field encoder that appends typed values to a byte buffer.

Each write_* method appends a value in a format that the corresponding FieldDecoder::read_* method can reconstruct. Variable-length values (strings, byte slices) are length-prefixed with a 4-byte big-endian u32.

Example

use noxu_persist::simple_serializer::{FieldEncoder, FieldDecoder};

let mut enc = FieldEncoder::new();
enc.write_u64(42);
enc.write_string("hello");
enc.write_bool(true);
let bytes = enc.finish();

let mut dec = FieldDecoder::new(&bytes);
assert_eq!(dec.read_u64().unwrap(), 42);
assert_eq!(dec.read_string().unwrap(), "hello");
assert_eq!(dec.read_bool().unwrap(), true);

Implementations

impl FieldEncoder

pub fn new() -> Self

Creates a new, empty encoder.

pub fn with_capacity(capacity: usize) -> Self

Creates a new encoder with the given initial capacity.

pub fn write_u8(&mut self, v: u8)

Writes a u8.

pub fn write_u16(&mut self, v: u16)

Writes a u16 in big-endian byte order.

pub fn write_u32(&mut self, v: u32)

Writes a u32 in big-endian byte order.

pub fn write_u64(&mut self, v: u64)

Writes a u64 in big-endian byte order.

pub fn write_i8(&mut self, v: i8)

Writes an i8.

pub fn write_i16(&mut self, v: i16)

Writes an i16 in big-endian byte order.

pub fn write_i32(&mut self, v: i32)

Writes an i32 in big-endian byte order.

pub fn write_i64(&mut self, v: i64)

Writes an i64 in big-endian byte order.

pub fn write_f32(&mut self, v: f32)

Writes a f32 in big-endian byte order.

pub fn write_f64(&mut self, v: f64)

Writes a f64 in big-endian byte order.

pub fn write_bool(&mut self, v: bool)

Writes a bool as a single byte (1 for true, 0 for false).

pub fn write_string(&mut self, s: &str)

Writes a length-prefixed UTF-8 string.

pub fn write_bytes(&mut self, b: &[u8])

Writes a length-prefixed byte slice.

pub fn write_option_string(&mut self, s: &Option<String>)

Writes an optional string. Encodes a leading bool tag followed by the string value when Some.

pub fn write_option_u64(&mut self, v: &Option<u64>)

Writes an optional u64. Encodes a leading bool tag followed by the value when Some.

pub fn finish(self) -> Vec<u8>

Consumes the encoder and returns the accumulated byte buffer.

pub fn len(&self) -> usize

Returns the number of bytes written so far.

pub fn is_empty(&self) -> bool

Returns true if no bytes have been written.

Trait Implementations

impl Clone for FieldEncoder

fn clone(&self) -> FieldEncoder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FieldEncoder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FieldEncoder

fn default() -> Self

Returns the “default value” for a type.