Enum DecodeError 

pub enum DecodeError {
    Empty,
    MissingBeginString,
    InvalidBodyLength,
    ZeroBodyLength,
    BodyLengthTooLarge {
        declared: usize,
        max: usize,
    },
    GroupNestingTooDeep {
        max: usize,
    },
    BodyLengthMismatch {
        declared: usize,
        actual: usize,
    },
    MissingMsgType,
    MissingChecksum,
    ChecksumMismatch {
        declared: u32,
        computed: u32,
    },
    GarbledField {
        offset: usize,
        reason: &'static str,
    },
    Truncated {
        offset: usize,
    },
    InvalidTag {
        offset: usize,
    },
}

Error decoding raw bytes into a Message.

Variants

Empty

The input was empty.

MissingBeginString

The message does not start with BeginString (tag 8).

InvalidBodyLength

BodyLength (tag 9) is missing or not a valid number.

ZeroBodyLength

BodyLength (tag 9) is declared as exactly 0 (BUG-100/FR-014, feature 007) — every real FIX message has a non-empty body (at minimum MsgType), matching QuickFIX/J (QFJ-903) and QuickFIX/Go, which both reject this rather than framing an empty-body message. Distinct from Self::InvalidBodyLength (missing/non-numeric) so the transport layer can treat it like Self::BodyLengthTooLarge — closing the connection outright — rather than the generic malformed-frame skip-and-resync recovery InvalidBodyLength gets.

BodyLengthTooLarge

BodyLength (tag 9) declares a frame larger than the configured/sane maximum (BUG-13/ FR-024, feature 006) — the connection must be closed instead of buffering unboundedly while waiting for that much data to arrive (a memory-exhaustion DoS vector, reachable pre- or post-Logon on any open acceptor port).

Fields

declared: usize

Value declared in tag 9.

max: usize

The configured/sane maximum.

GroupNestingTooDeep

Dictionary-driven repeating-group nesting exceeded the defensive recursion limit.

Fields

max: usize

Maximum supported nesting depth.

BodyLengthMismatch

The declared BodyLength does not match the actual body size.

Fields

declared: usize

Value declared in tag 9.

actual: usize

Actual measured body length.

MissingMsgType

The third field is not MsgType (tag 35) — BUG-80/FR-049 (feature 007): every real FIX message has a MsgType immediately after BeginString/BodyLength (matching QuickFIX/J and QuickFIX/Go, which both require it); a message missing it entirely was previously accepted.

MissingChecksum

CheckSum (tag 10) is missing or not a valid number.

ChecksumMismatch

The declared CheckSum does not match the computed one.

Fields

declared: u32

Value declared in tag 10.

computed: u32

Locally computed checksum.

GarbledField

A field could not be parsed.

Fields

offset: usize

Byte offset where the problem was detected.

reason: &'static str

Human-readable reason.

Truncated

The input ended before a field was complete.

Fields

offset: usize

Byte offset where truncation was detected.

InvalidTag

A tag number was not a valid positive integer.

Fields

offset: usize

Byte offset of the offending tag.

Trait Implementations

impl Clone for DecodeError

fn clone(&self) -> DecodeError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DecodeError

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

Formats the value using the given formatter.

impl Display for DecodeError

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

Formats the value using the given formatter.

impl Eq for DecodeError

impl Error for DecodeError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for DecodeError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DecodeError