Struct ObjectHeader 

pub struct ObjectHeader {
    pub flags: u8,
    pub messages: Vec<ObjectHeaderMessage>,
}

Object Header v2.

Fields

flags: u8

Header flags byte. Bits 0-1 control chunk0 size encoding. Other bits control optional fields (timestamps, attr thresholds, creation order).

messages: Vec<ObjectHeaderMessage>

The ordered list of header messages.

Implementations

impl ObjectHeader

pub fn new() -> Self

Create a new, empty object header with default flags.

Defaults: bits 0-1 = 2 (4-byte chunk size encoding), no timestamps, no attribute creation order, no non-default thresholds.

pub fn add_message(&mut self, msg_type: u8, flags: u8, data: Vec<u8>)

Append a message to the object header.

pub fn encode(&self) -> Vec<u8>

Encode the object header to a byte vector, including “OHDR” signature and trailing checksum.

pub fn decode(buf: &[u8]) -> FormatResult<(Self, usize)>

Decode an object header from a byte buffer. Returns the parsed header and the number of bytes consumed from the buffer.

impl ObjectHeader

pub fn decode_v1(buf: &[u8]) -> FormatResult<(Self, usize)>

Decode a v1 object header from a byte buffer.

v1 headers do NOT have the “OHDR” signature or a checksum. The layout is:

Byte 0: version = 1
Byte 1: reserved
Bytes 2-3: num_messages (u16 LE)
Bytes 4-7: obj_ref_count (u32 LE)
Bytes 8-11: header_data_size (u32 LE) — size of message data in first chunk
Messages follow, each:
  type: u16 LE
  data_size: u16 LE
  flags: u8
  reserved: 3 bytes
  data: data_size bytes (padded to 8-byte alignment)

pub fn decode_any(buf: &[u8]) -> FormatResult<(Self, usize)>

Auto-detect and decode either v1 or v2 object header.

Checks for the “OHDR” signature to decide v2; otherwise tries v1.

Trait Implementations

impl Clone for ObjectHeader

fn clone(&self) -> ObjectHeader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ObjectHeader

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

Formats the value using the given formatter.

impl Default for ObjectHeader

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ObjectHeader

impl PartialEq for ObjectHeader

fn eq(&self, other: &ObjectHeader) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ObjectHeader