Enum MatError 

#[non_exhaustive]
pub enum MatError {
    Hdf5(Error),
    Format(FormatError),
    Io(Error),
    RootMustBeStruct,
    UnsupportedType(&'static str),
    MixedSequenceElementTypes,
    RaggedMatrix {
        expected: usize,
        got: usize,
    },
    ShapeMismatch {
        expected: String,
        actual: String,
    },
    MissingField(String),
    UnknownClass(String),
    UnsupportedMatlabClass(String),
    Utf16Decode(String),
    BlockSizeMismatch {
        block: usize,
        expected: usize,
        actual: usize,
    },
    CompressionUnsupportedForBlocks,
    Custom(String),
}

Errors that can occur when (de)serializing .mat v7.3 files.

Marked #[non_exhaustive]: reading MATLAB’s MCOS opaque classes is an ongoing effort (datetime, categorical, table, containers.Map, dictionary, …), and each newly decoded — or newly refused — class can introduce a more specific error variant. Keeping the enum open lets those additions land without a breaking change, so downstream matches must include a wildcard arm.

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.

Hdf5(Error)

Underlying HDF5 I/O or format error.

Format(FormatError)

Underlying HDF5 format parse error.

Io(Error)

I/O error when reading or writing a file path.

RootMustBeStruct

Top-level must be a struct with named fields (each field becomes a MATLAB variable).

UnsupportedType(&'static str)

The requested Rust type has no MATLAB v7.3 encoding in this crate.

MixedSequenceElementTypes

A sequence contained elements of different primitive types.

RaggedMatrix

A 2-D matrix had inconsistent row lengths.

Fields

expected: usize

Expected row length (first row).

got: usize

The row that differed.

ShapeMismatch

A dataset’s on-disk shape didn’t match the Rust type.

Fields

expected: String

The Rust side’s expectation.

actual: String

What the file contained.

MissingField(String)

A required struct field was missing from the file.

UnknownClass(String)

A MATLAB_class attribute value wasn’t recognized.

UnsupportedMatlabClass(String)

A recognized but not-yet-supported MATLAB class was encountered on read — an MCOS opaque class (datetime, categorical, table, containers.Map, dictionary, an enumeration, a user classdef, …) whose decoder is not yet implemented. Refused by name rather than misread; the modern string class is supported.

Utf16Decode(String)

UTF-16 decoding of a char dataset failed.

BlockSizeMismatch

A DataProducer wrote the wrong number of bytes for a block. Refused rather than written: a block of the wrong size displaces every address after it, and the result would be a file that fails to open for reasons that no longer point back here.

Fields

block: usize

Block index the producer was asked for.

expected: usize

Bytes it had to write, as Blocking::block_len reports.

actual: usize

Bytes it actually wrote.

CompressionUnsupportedForBlocks

A producer-backed dataset was asked for on a builder configured for compression. The layout needs each block’s exact on-disk size before it writes anything, and a compressed block’s size is not knowable without compressing it — which would buffer the data the path exists to avoid.

Custom(String)

A generic serde-originated error (from Error::custom).

Trait Implementations

impl Debug for MatError

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

Formats the value using the given formatter.

impl Display for MatError

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

Formats the value using the given formatter.

impl Error for MatError

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 Error for MatError

Available on crate feature serde only.

fn custom<T: Display>(msg: T) -> Self

Used when a Serialize implementation encounters any error while serializing a type.

impl Error for MatError

Available on crate feature serde only.

fn custom<T: Display>(msg: T) -> Self

Raised when there is general error when deserializing a type.

fn invalid_type(unexp: Unexpected<'_>, exp: &dyn Expected) -> Self

Raised when a Deserialize receives a type different from what it was expecting.

fn invalid_value(unexp: Unexpected<'_>, exp: &dyn Expected) -> Self

Raised when a Deserialize receives a value of the right type but that is wrong for some other reason.

fn invalid_length(len: usize, exp: &dyn Expected) -> Self

Raised when deserializing a sequence or map and the input data contains too many or too few elements.

fn unknown_variant(variant: &str, expected: &'static [&'static str]) -> Self

Raised when a Deserialize enum type received a variant with an unrecognized name.

fn unknown_field(field: &str, expected: &'static [&'static str]) -> Self

Raised when a Deserialize struct type received a field with an unrecognized name.

fn missing_field(field: &'static str) -> Self

Raised when a Deserialize struct type expected to receive a required field with a particular name but that field was not present in the input.

fn duplicate_field(field: &'static str) -> Self

Raised when a Deserialize struct type received more than one of the same field.

impl From<Error> for MatError

fn from(e: Hdf5Error) -> Self

Converts to this type from the input type.

impl From<Error> for MatError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<FormatError> for MatError

fn from(e: FormatError) -> Self

Converts to this type from the input type.