Enum Error 

#[non_exhaustive]
pub enum Error {
    UnexpectedEof,
    InvalidTagControl(u8),
    InvalidElementType(u8),
    InvalidUtf8(Utf8Error),
    IntegerOutOfRange,
    BufferTooSmall,
    LengthOverflow,
    UnexpectedEndOfContainer,
    UnclosedContainer,
    ContainerTooDeep,
    NonAnonymousArrayTag,
    ElementBudgetExceeded,
    InternalSliceConversion,
}

All errors matter-codec can produce.

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.

UnexpectedEof

The reader reached the end of the input before completing an element.

InvalidTagControl(u8)

The reader encountered a tag-control byte that does not match any defined tag form.

InvalidElementType(u8)

The reader encountered an element-type code that is not defined by the spec or is not yet supported by this crate.

InvalidUtf8(Utf8Error)

A UTF-8 string element contained an invalid byte sequence.

Produced by TlvReader::next when reading a UTF-8 element whose payload bytes fail core::str::from_utf8 validation.

IntegerOutOfRange

An integer payload could not be represented in the declared width.

BufferTooSmall

The writer was asked to emit into a buffer that has no room.

Reserved for the fixed-buffer writer variant; the Vec<u8>-backed writer used in phase 1 cannot trigger this.

LengthOverflow

A length field would exceed usize::MAX.

UnexpectedEndOfContainer

A bare end-of-container marker (0x18) was read at the top level, with no container open.

UnclosedContainer

End of input was reached while reading the children of a container, before a closing end-of-container marker arrived.

ContainerTooDeep

A container was opened at a depth that exceeds the reader’s nesting limit (32 levels per the Matter spec recommendation).

NonAnonymousArrayTag

An array child carried a non-anonymous tag. The Matter spec requires every array element to be anonymous; the decoder fails closed rather than silently discarding the offending tag.

ElementBudgetExceeded

A single tree-builder decode produced more elements than the configured budget allows. This bounds memory amplification from inputs packed with many tiny scalars.

InternalSliceConversion

An internal fixed-width byte-slice conversion failed. The preceding bounds check guarantees the slice length, so this branch is effectively unreachable; it exists so the conversion is never mislabeled as a different failure mode.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 From<Utf8Error> for Error

fn from(source: Utf8Error) -> Self

Converts to this type from the input type.