Enum Error 

#[non_exhaustive]
pub enum Error {
    InvalidPartitionOffset,
    InvalidPartitionSize,
    FlashError,
    NamespaceNotFound,
    NamespaceTooLong,
    NamespaceMalformed,
    ValueTooLong,
    KeyMalformed,
    KeyTooLong,
    KeyNotFound,
    ItemTypeMismatch(ItemType),
    CorruptedData,
    FlashFull,
    PageFull,
}

Errors that can occur during NVS operations. The list is likely to stay as is but marked as non-exhaustive to allow for future additions without breaking the API. A caller would likely only need to handle NamespaceNotFound and KeyNotFound as the other errors are static.

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.

InvalidPartitionOffset

The partition offset has to be aligned to the size of a flash sector (4k)

InvalidPartitionSize

The partition size has to be a multiple of the flash sector size (4k)

FlashError

The internal error value is returned from the provided &mut impl flash::Flash

NamespaceNotFound

Namespace not found. Either the flash was corrupted and silently fixed on startup or no value has been written yet.

NamespaceTooLong

The max namespace length is 15 bytes plus null terminator.

NamespaceMalformed

The namespace is malformed. The last byte must be b’\0’

ValueTooLong

Strings are limited to MAX_BLOB_DATA_PER_PAGE while blobs can be up to MAX_BLOB_SIZE bytes

KeyMalformed

The key is malformed. The last byte must be b’\0’

KeyTooLong

The max key length is 15 bytes plus null terminator.

KeyNotFound

Key not found. Either the flash was corrupted and silently fixed on or no value has been written yet.

ItemTypeMismatch(ItemType)

The encountered item type is reported

CorruptedData

Blob data is corrupted or inconsistent

FlashFull

Flash is full and defragmentation doesn’t help.

PageFull

Used internally to indicate that we have to allocate a new page.

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

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Error