Enum TextEditError 

#[non_exhaustive]
pub enum TextEditError {
    StaleMatch {
        match_id: MatchId,
        reason: StaleReason,
    },
    InvalidMatchId {
        reason: String,
    },
    InvalidQuery {
        reason: String,
    },
    OverlappingEdits {
        a: MatchId,
        b: MatchId,
    },
    DuplicateStage {
        match_id: MatchId,
    },
    UnsupportedContainer {
        match_id: MatchId,
        kind: UnsupportedContainer,
    },
    UnsupportedStyleSpan {
        match_id: MatchId,
        detail: String,
    },
    EncodingFailed {
        match_id: Option<MatchId>,
        font: String,
        detail: String,
    },
    FontFallbackDenied {
        match_id: Option<MatchId>,
        font: String,
        detail: String,
    },
    TaggedTextConflict {
        match_id: MatchId,
        visual_text: String,
        actual_text: String,
    },
    SignedDocumentRejected {
        signatures: Vec<SignatureSummary>,
    },
    PermissionsDenied,
    UnsupportedFitPolicy {
        policy: FitPolicy,
    },
    Document(ManipError),
    Internal {
        detail: String,
    },
}

Typed errors of the text-edit engine.

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.

StaleMatch

The locator does not resolve against the current document revision.

Fields

match_id: MatchId

The stale locator.

reason: StaleReason

Why it is stale.

InvalidMatchId

The token could not be decoded or failed strict validation.

Fields

reason: String

Decoder diagnostics.

InvalidQuery

The query is malformed (e.g. empty needle).

Fields

reason: String

What was wrong.

OverlappingEdits

Two staged edits overlap in the same container.

Fields

a: MatchId

First edit.

b: MatchId

Second edit.

DuplicateStage

The same match was staged twice.

Fields

match_id: MatchId

The duplicated locator.

UnsupportedContainer

The match lives in a container the engine cannot edit yet.

Fields

match_id: MatchId

The match.

kind: UnsupportedContainer

Container kind.

UnsupportedStyleSpan

The match spans text with differing font/size/style.

Fields

match_id: MatchId

The match.

detail: String

Which styles differ.

EncodingFailed

Replacement (or retained) text could not be encoded.

Fields

match_id: Option<MatchId>

The edit, when attributable.

font: String

Font that could not encode the text.

detail: String

Encoder diagnostics.

FontFallbackDenied

The original font cannot encode the replacement and the policy is FontFallback::Deny.

Fields

match_id: Option<MatchId>

The edit, when attributable.

font: String

The original font.

detail: String

Why the original font failed.

TaggedTextConflict

The match is covered by /ActualText (design §7).

Fields

match_id: MatchId

The match.

visual_text: String

Decoded glyph text.

actual_text: String

The enclosing /ActualText value.

SignedDocumentRejected

The document carries digital signatures and the policy is SignaturePolicy::RejectSignedDocuments.

Fields

signatures: Vec<SignatureSummary>

The signatures found.

PermissionsDenied

Document permissions forbid content modification.

UnsupportedFitPolicy

The requested fit policy is not implemented in this phase.

Fields

policy: FitPolicy

The requested policy.

Document(ManipError)

Underlying document error.

Internal

Invariant violation — please report.

Fields

detail: String

Diagnostics.

Trait Implementations

impl Debug for TextEditError

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

Formats the value using the given formatter.

impl Display for TextEditError

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

Formats the value using the given formatter.

impl Error for TextEditError

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<ManipError> for TextEditError

fn from(source: ManipError) -> Self

Converts to this type from the input type.