Enum GffPathError 

pub enum GffPathError {
    EmptyPath,
    IndexAtRoot {
        path: String,
    },
    NoSuchField {
        at: String,
        label: String,
    },
    AmbiguousLabel {
        at: String,
        label: String,
        count: usize,
    },
    IndexOutOfRange {
        at: String,
        index: usize,
        len: usize,
    },
    NotAList {
        at: String,
        actual: &'static str,
    },
    NotAStruct {
        at: String,
        actual: &'static str,
    },
    TypeMismatch {
        at: String,
        existing: &'static str,
        replacement: &'static str,
    },
    AlreadyExists {
        at: String,
    },
    WrongSegmentKind {
        at: String,
        operation: &'static str,
        expected: &'static str,
    },
}

A path that does not resolve, or an edit the tree will not take.

A Result rather than a hit-plus-diagnostics pair. A tier walk can half succeed, answering from a lower tier while a higher one was unreadable, and both halves matter. Addressing a path cannot: it arrives or it does not, for one reason.

Variants

EmptyPath

A path with no segments names nothing to act on.

IndexAtRoot

A path started by indexing, with no list yet in hand.

Fields

path: String

The path as supplied.

NoSuchField

The struct has no field under that label.

Fields

at: String

Where the walk had reached.

label: String

The label looked for.

AmbiguousLabel

The struct carries that label more than once.

Which copy the caller meant is not recoverable from the path, and the copies are not known to agree on anything but their value today.

Fields

at: String

Where the walk had reached.

label: String

The label looked for.

count: usize

How many fields carry it.

IndexOutOfRange

The list is shorter than the index.

Fields

at: String

Where the walk had reached.

index: usize

The index asked for.

len: usize

How many elements the list holds.

NotAList

A field was indexed and is not a list.

Fields

at: String

Where the walk had reached.

actual: &'static str

The type actually found.

NotAStruct

A field was descended into and is not a struct.

Fields

at: String

Where the walk had reached.

actual: &'static str

The type actually found.

TypeMismatch

The replacement is a different type from what the field holds.

The existing field’s type is the only oracle available here. The per-format schemas that could answer “what should this label be” live in rakata-generics, above this crate, and asking that question is validation, which belongs to lint.

Fields

at: String

The field being replaced.

existing: &'static str

The type currently stored.

replacement: &'static str

The type offered.

AlreadyExists

insert was given a label the struct already carries.

Fields

at: String

The field that is already present.

WrongSegmentKind

A field operation ended at a list index, or the reverse.

Fields

at: String

The path as supplied.

operation: &'static str

The operation that could not use it.

expected: &'static str

The kind of last segment the operation needs.

Trait Implementations

impl Clone for GffPathError

fn clone(&self) -> GffPathError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GffPathError

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

Formats the value using the given formatter.

impl Display for GffPathError

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

Formats the value using the given formatter.

impl Error for GffPathError

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<GffPathError> for GffDocumentError

fn from(source: GffPathError) -> Self

Converts to this type from the input type.

impl PartialEq for GffPathError

fn eq(&self, other: &GffPathError) -> 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 Eq for GffPathError

impl StructuralPartialEq for GffPathError