Struct KeySerializer 

pub struct KeySerializer<'a, B: Buffer> { /* private fields */ }

Serializes keys sequentially into binary format suitable for lexicographical comparisons.

The key layout contains:

• Sequences of 255-byte chunks, each prefixed with a 1-byte length.
• If a serialized key is <= 254 bytes, it is represented as a single chunk with a 1-byte length.
• If exactly a multiple of 255 bytes, it is terminated by a 0-length chunk.

Implementations

impl<'a, B: Buffer> KeySerializer<'a, B>

pub fn new(buffer: &'a mut B, base: Option<u64>) -> Self

Creates a new KeySerializer attached to a persistent storage buffer.

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

Writes an order-preserving varint-encoded 64-bit payload to the buffer without base delta encoding.

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

Writes an order-preserving varint-encoded 64-bit payload to the buffer.

If a delta base was provided and this is the first item written, it writes the delta v - base. Otherwise, writes v as an order-preserving varint.

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

Writes a raw byte slice into the serialization stream. Non-terminal fields are assumed to fit within the initial chunk.

pub fn write_last(self, bytes: &[u8]) -> KeySerializerFinalized

Writes trailing variable-length dynamic bytes to the serialization buffer, crossing chunk boundaries as needed, then immediately finalizes the key.

pub fn finalize(self) -> KeySerializerFinalized

Resolves chunk lengths and finalizes the key serialization.

Trait Implementations

impl<B: Buffer> From<KeySerializer<'_, B>> for KeySerializerFinalized

fn from(serializer: KeySerializer<'_, B>) -> Self

Converts to this type from the input type.

impl<'a, B: Buffer + 'a> MergeSerializerOutput<KeySerializer<'a, B>> for KeySerializer<'a, B>

type Output = KeySerializer<'a, B>

impl<'a, B: Buffer + 'a> MergeSerializerOutput<KeySerializer<'a, B>> for KeySerializerFinalized

type Output = KeySerializerFinalized

impl<'a, B: Buffer + 'a> MergeSerializerOutput<KeySerializerFinalized> for KeySerializer<'a, B>

type Output = KeySerializerFinalized