Enum DropReason 

#[non_exhaustive]
pub enum DropReason {
    SampleTooLarge,
    FragmentSizeInvalid,
    FragmentIndexZero,
    FragmentIndexOutOfRange,
    PayloadSizeMismatch,
    InconsistentWithBuffered,
    FragmentsInSubmessageInvalid,
    PendingSnsCapExceeded,
    AssemblerDisabled,
}

Rejected-fragment category — for diagnostics only.

Adding new variants: when changing this, also adapt the DropReason::as_str method (exhaustive match), otherwise the build breaks. This is intentional — it prevents new failure modes from being silently lost in logging/metrics paths.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

SampleTooLarge

sample_size over the cap.

FragmentSizeInvalid

fragment_size over the cap or == 0.

FragmentIndexZero

fragment_starting_num == 0 (1-based expected).

FragmentIndexOutOfRange

Fragment index beyond total_fragments.

PayloadSizeMismatch

Payload length does not match the fragment position.

InconsistentWithBuffered

A later DataFrag contradicts an already stored one (different sample_size or fragment_size).

FragmentsInSubmessageInvalid

fragments_in_submessage == 0 or inconsistent.

PendingSnsCapExceeded

The number of simultaneously managed SNs would exceed max_pending_sns — the oldest incomplete SN was discarded.

AssemblerDisabled

max_pending_sns == 0 — the assembler accepts no entries.

Implementations

impl DropReason

pub const fn as_str(self) -> &'static str

Stable string representation for logging/metrics. Exhaustive match — new variants intentionally break the build here.

Trait Implementations

impl Clone for DropReason

fn clone(&self) -> DropReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DropReason

impl Debug for DropReason

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

Formats the value using the given formatter.

impl Display for DropReason

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

Formats the value using the given formatter.

impl Eq for DropReason

impl PartialEq for DropReason

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DropReason