Enum SparkplugError 

#[non_exhaustive]
pub enum SparkplugError {
    InvalidTopic(String),
    InvalidId(String),
    Truncated,
    VarintOverflow,
    InvalidWireType(u8),
    InvalidUtf8,
    UnknownDataType(u32),
    MissingDataType(String),
    ArrayLength {
        len: usize,
        width: usize,
    },
    DataSetShape(String),
    ValueTypeMismatch(String),
    RecursionLimit,
    InvalidState(String),
    Io(Error),
    Transport(String),
}

Errors produced while building, encoding, decoding, or parsing Sparkplug B data.

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.

InvalidTopic(String)

A topic string was not a valid Sparkplug B topic.

InvalidId(String)

A Group/Edge-Node/Device identifier was empty or contained a reserved character (+, /, #).

Truncated

The protobuf byte stream ended unexpectedly.

VarintOverflow

A protobuf varint exceeded 64 bits.

InvalidWireType(u8)

A protobuf field used a wire type the schema does not allow.

InvalidUtf8

A string field was not valid UTF-8.

UnknownDataType(u32)

A datatype code on the wire was not one of the enumerated Sparkplug data types.

MissingDataType(String)

A DATA/CMD metric omitted its datatype and it could not be recovered from a prior birth (by name or alias).

ArrayLength

A packed numeric array had a length that is not a multiple of the element width.

Fields

len: usize

The byte length found on the wire.

width: usize

The expected per-element width in bytes.

DataSetShape(String)

A DataSet’s columns/types/rows shapes were inconsistent.

ValueTypeMismatch(String)

A metric’s value did not match the field set expected for its datatype.

RecursionLimit

Decoding hit the maximum nesting depth (defends against hostile inputs).

InvalidState(String)

A STATE JSON payload was malformed.

Io(Error)

An I/O error from bdSeq persistence.

Transport(String)

An MQTT transport error (connect/subscribe/publish/receive).

Trait Implementations

impl Debug for SparkplugError

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

Formats the value using the given formatter.

impl Display for SparkplugError

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

Formats the value using the given formatter.

impl Error for SparkplugError

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

fn from(source: Error) -> Self

Converts to this type from the input type.