Struct Message 

pub struct Message {
    pub class: u8,
    pub msg_type: u8,
    pub parameters: Vec<Parameter>,
}

A whole M3UA message: class, type and its parameters in wire order.

Fields

class: u8

msg_type: u8

parameters: Vec<Parameter>

Implementations

impl Message

pub fn new(class: u8, msg_type: u8) -> Self

pub fn with(self, parameter: Parameter) -> Self

pub fn with_opt_u32(self, tag: u16, value: Option<u32>) -> Self

Append parameter only when value is present. Every optional parameter in this file goes through here, so “omitted” and “present but zero” stay distinguishable.

pub fn with_opt(self, tag: u16, value: Option<Vec<u8>>) -> Self

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

Encode to the wire. The Message Length includes the common header and every parameter’s padding.

Refuses anything parse_header would reject, which is the asymmetry this whole class of finding is named after: MAX_MESSAGE_LEN bounded the decode side, against a hostile peer, and nothing bounded the encode side, against the model. A message whose parameters ran past the ceiling encoded happily and was then rejected by this codec’s own parser at the far end.

pub fn parse(full: &[u8]) -> Result<Message, WireError>

Decode a complete message: the common header followed by exactly length - 8 body octets. full must be the declared length, which is what mod.rs’s reader supplies.

pub fn param(&self, tag: u16) -> Option<&Parameter>

pub fn param_u32(&self, tag: u16) -> Option<u32>

pub fn name(&self) -> &'static str

Trait Implementations

impl Clone for Message

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Message

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

Formats the value using the given formatter.

impl Eq for Message

impl PartialEq for Message

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Message