Enum WorkbookError 

#[non_exhaustive]
pub enum WorkbookError {
    EmptyLiteral,
    Validation(String),
    SheetManagement(String),
    Mutation(String),
}

Errors from workbook value-type constructors and from Workbook::from_json / Workbook::to_json.

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.

EmptyLiteral

A formula-less cell whose value is empty is invalid: it would be byte-distinguishable from the absent cell it denotes, breaking canonical uniqueness (schema spec §4). Clear a cell by removing its entry from the sheet’s cell map instead.

Validation(String)

A document-level rule was violated while parsing or serializing — a rule serde cannot express (schema spec §1, §2, §3, §5, §7, §8) or a resource-limit breach (scope ADR Decision 5). Carries a human-readable description of the first violation found.

SheetManagement(String)

A sheet-management operation (add_sheet, insert_sheet, rename_sheet, move_sheet) violated an invariant — a duplicate sheet name under simple case folding (schema spec §2), a name that is empty or exceeds the length limit (schema spec §3), the per-workbook sheet cap (scope ADR Decision 5), an out-of-range tab position, or an unknown sheet name. Carries a human-readable description.

Mutation(String)

A workbook-level mutation (set, define_name, redefine_name) violated an invariant — an empty-literal write (use clear), an unknown sheet, a syntactically invalid formula for the locked engine, an invalid or non-canonical named-range name/ref, a ref to a missing sheet (schema spec §7), a duplicate name under simple case folding, or a per-mutation resource cap (cells / text / array / formula / named-range count, scope ADR Decision 5). Carries a human-readable description.

Trait Implementations

impl Clone for WorkbookError

fn clone(&self) -> WorkbookError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkbookError

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

Formats the value using the given formatter.

impl Display for WorkbookError

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

Formats the value using the given formatter.

impl Eq for WorkbookError

impl Error for WorkbookError

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 WorkbookError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WorkbookError