Struct RawMessage 

pub struct RawMessage<'a> { /* private fields */ }

Zero-copy view into a FIX message buffer.

This struct holds references to the original message buffer, avoiding allocation during parsing. Fields are stored as offset ranges into the buffer.

Range convention

Every stored range is relative to buffer, not to whatever larger buffer the message may have been decoded from. A decoder that reads several messages out of one input must rebase its offsets by the start of the current message before constructing a RawMessage; RawMessage::new rejects any range that does not lie within buffer.

Implementations

impl<'a> RawMessage<'a>

pub fn new( buffer: &'a [u8], begin_string: Range<usize>, body: Range<usize>, msg_type: MsgType, fields: SmallVec<[FieldRef<'a>; 32]>, ) -> Result<Self, DecodeError>

Creates a new RawMessage from parsed components.

Arguments

• buffer - The complete message buffer
• begin_string - Range of the BeginString value, relative to buffer
• body - Range of the message body, relative to buffer
• msg_type - The parsed message type
• fields - Parsed field references

Errors

Returns DecodeError::RangeOutOfBounds if begin_string or body is inverted or does not lie within buffer. Every offset here derives from attacker-supplied bytes, so the bounds are checked once at construction rather than at every accessor.

pub const fn buffer(&self) -> &'a [u8]

Returns the complete message buffer.

pub fn begin_string(&self) -> Result<&'a str, DecodeError>

Returns the BeginString value (e.g., “FIX.4.4”).

Errors

Returns DecodeError::InvalidUtf8 if the BeginString bytes are not valid UTF-8, or DecodeError::RangeOutOfBounds if the stored range escapes the buffer. The value is never silently defaulted to "".

pub fn body(&self) -> Result<&'a [u8], DecodeError>

Returns the message body bytes (after BodyLength, before the checksum).

Errors

Returns DecodeError::RangeOutOfBounds if the stored range escapes the buffer.

pub fn msg_type(&self) -> &MsgType

Returns the message type.

pub fn fields(&self) -> impl Iterator<Item = &FieldRef<'a>>

Returns an iterator over all fields.

pub fn field_count(&self) -> usize

Returns the number of fields in the message.

pub fn get_field(&self, tag: u32) -> Option<&FieldRef<'a>>

Gets a field by tag number.

Arguments

• tag - The field tag number

Returns

The first field with the given tag, or None if not found.

pub fn get_field_str(&self, tag: u32) -> Option<&'a str>

Gets a field value as a string.

Arguments

• tag - The field tag number

Returns

The field value as a string, or None if not found or invalid UTF-8.

pub fn get_field_as<T: FromStr>(&self, tag: u32) -> Result<T, DecodeError>

Gets a field value parsed as the specified type.

Arguments

• tag - The field tag number

Errors

Returns DecodeError if the field is not found or cannot be parsed.

pub fn body_range(&self) -> &Range<usize>

Returns the message body range.

pub fn len(&self) -> usize

Returns the message length in bytes.

pub fn is_empty(&self) -> bool

Returns true if the message is empty.

pub fn to_owned(&self) -> OwnedMessage

Converts this borrowed message to an owned message.

Trait Implementations

impl<'a> Clone for RawMessage<'a>

fn clone(&self) -> RawMessage<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for RawMessage<'a>

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

Formats the value using the given formatter.