Enum Error 

pub enum Error {
    Basic(BasicError),
    Style(StyleError),
    Serde(SerdeErr),
    Save(SaveError),
    Parse(ParseError),
    UnavailableSheetIdx(usize),
    PayloadError(String),
    DuplicateBlockKey {
        block: String,
        key: String,
    },
    PayloadFailed {
        index: usize,
        total: usize,
        payload: String,
        source: Box<Error>,
    },
    While {
        doing: String,
        source: Box<Error>,
    },
}

Every failure the engine reports. A write never surfaces this directly: a rejected transaction is turned into ActionEffect::error_message, with the failing payload wrapped in PayloadFailed.

Variants

Basic(BasicError)

Style(StyleError)

Serde(SerdeErr)

Save(SaveError)

Parse(ParseError)

UnavailableSheetIdx(usize)

PayloadError(String)

DuplicateBlockKey

A write would have given two records of one block the same row key. (block, key, field) is the addressing scheme, so a repeat makes one record unreachable and every aggregate over the block wrong — and does it silently, which is why this is a refusal rather than a warning.

Fields

block: String

key: String

PayloadFailed

index indexes the payload list the caller sent, and payload is that entry in the JSON shape it arrived in.

Fields

index: usize

total: usize

payload: String

source: Box<Error>

While

BasicError::While for the layers above the coordinate/id conversions, which know the request in names and A1 rather than ids.

Fields

doing: String

source: Box<Error>

Implementations

impl Error

pub fn at_payload( self, index: usize, total: usize, payload: &EditPayload, ) -> Error

Record which payload of a transaction raised this error.

pub fn code(&self) -> usize

The coarse category reported to hosts as ErrorMessage::ty. A wrapper reports the category of what it wraps: it says where, not what.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

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

fn from(source: BasicError) -> Error

Converts to this type from the input type.

impl From<Error> for ErrorMessage

fn from(value: Error) -> ErrorMessage

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(source: ParseError) -> Error

Converts to this type from the input type.

impl From<SaveError> for Error

fn from(source: SaveError) -> Error

Converts to this type from the input type.

impl From<SerdeErr> for Error

fn from(source: SerdeErr) -> Error

Converts to this type from the input type.

impl From<StyleError> for Error

fn from(source: StyleError) -> Error

Converts to this type from the input type.