Enum Error 

#[non_exhaustive]
pub enum Error {
    NonFiniteCoordinate {
        axis: &'static str,
        value: f64,
    },
    TooFewElements {
        geometry: &'static str,
        minimum: usize,
        spec: Option<&'static str>,
        id: Option<Id>,
        detail: Option<String>,
    },
    InvalidElementCount {
        geometry: &'static str,
        expected: usize,
        actual: usize,
        spec: Option<&'static str>,
    },
    IdenticalPositions {
        first: DirectPosition,
        second: DirectPosition,
    },
    AdjacentDuplicatePositions {
        index: usize,
        position: DirectPosition,
    },
    RepeatedClosingVertex {
        position: DirectPosition,
    },
    InvalidEnvelopeBounds {
        axis: &'static str,
        lower: f64,
        upper: f64,
    },
    NotSurfaceOrVolume {
        non_zero_extents: u8,
    },
    NotASurface {
        non_zero_extents: u8,
    },
    NotAVolume {
        non_zero_extents: u8,
    },
    EmptyId,
    TriangulationFailed {
        context: String,
    },
    MissingExteriorRing,
    UnresolvedRingReference {
        href: Option<String>,
    },
    UnresolvedSurfaceReference {
        href: Option<String>,
    },
    UnresolvedCurveReference {
        href: Option<String>,
    },
    MissingExteriorShell,
    UnresolvedShellReference {
        href: Option<String>,
    },
    TriangulationNotSupported {
        geometry: &'static str,
    },
    InvalidAttributeValue {
        attribute: &'static str,
        value: String,
    },
}

Errors returned by egml-core operations.

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.

NonFiniteCoordinate

Returned when a floating-point coordinate is not finite (NaN or ±infinity).

axis names the offending component ("x", "y", or "z"); value is the actual non-finite number that was supplied.

Fields

axis: &'static str

value: f64

TooFewElements

Returned when a collection has fewer elements than the minimum required by the GML geometry constraint.

Optional fields carry progressively more context: spec cites the ISO clause, id names the offending GML object, and detail gives a human-readable description of the actual content that was supplied.

Fields

geometry: &'static str

minimum: usize

spec: Option<&'static str>

id: Option<Id>

detail: Option<String>

InvalidElementCount

Returned when a collection has a number of elements other than the exact count required by the GML geometry constraint.

expected is the required count; actual is what was supplied. spec optionally cites the ISO/OGC clause that mandates the count.

Fields

geometry: &'static str

expected: usize

actual: usize

spec: Option<&'static str>

IdenticalPositions

Returned when two positions that must be distinct are identical.

Applies to Triangle vertices (OGC 07-036 §10.5.12.5).

Fields

first: DirectPosition

second: DirectPosition

AdjacentDuplicatePositions

Returned when adjacent positions in a sequence are equal.

index is the zero-based index of the first position in the duplicate pair; position is its value. Applies to LinearRing (OGC 07-036 §10.5.8) and LineString (OGC 07-036 §10.4.4).

Fields

index: usize

position: DirectPosition

RepeatedClosingVertex

Returned when the first and last position of a ring are equal.

position is the repeated vertex. A gml:LinearRing is implicitly closed and must not include an explicit closing vertex (OGC 07-036 §10.5.8).

Fields

position: DirectPosition

InvalidEnvelopeBounds

Returned when an Envelope is constructed with a lower corner that strictly exceeds the upper corner along axis.

lower and upper are the actual conflicting coordinate values. OGC 07-036 §10.1.4.6 requires lowerCorner ≤ upperCorner in every component.

Fields

axis: &'static str

lower: f64

upper: f64

NotSurfaceOrVolume

Returned when Envelope::to_triangulated_surface is called on an envelope that is neither a surface nor a volume.

non_zero_extents is the number of axes with non-zero extent (0 or 1).

Fields

non_zero_extents: u8

NotASurface

Returned when Envelope::to_polygon is called on an envelope that does not have exactly two non-zero extents.

non_zero_extents is the actual number of axes with non-zero extent.

Fields

non_zero_extents: u8

NotAVolume

Returned when Envelope::to_solid is called on an envelope that does not have all three extents non-zero.

non_zero_extents is the actual number of axes with non-zero extent.

Fields

non_zero_extents: u8

EmptyId

Returned when an empty string is used to construct a Id.

TriangulationFailed

Returned when the earcut polygon triangulation algorithm produces no triangles.

context provides additional information about which polygon or patch could not be decomposed.

Fields

context: String

MissingExteriorRing

Returned when an operation requires an exterior ring but the polygon has none.

UnresolvedRingReference

Returned when a ring property carries only an xlink:href reference and the referenced geometry object has not been resolved into an inline object.

href is the reference value if one was present, or None if the property has neither an inline object nor a reference.

Fields

href: Option<String>

UnresolvedSurfaceReference

Returned when a surface property carries only an xlink:href reference and the referenced geometry object has not been resolved into an inline object.

href is the reference value if one was present, or None if the property has neither an inline object nor a reference.

Fields

href: Option<String>

UnresolvedCurveReference

Returned when a curve property carries only an xlink:href reference and the referenced geometry object has not been resolved into an inline object.

href is the reference value if one was present, or None if the property has neither an inline object nor a reference.

Fields

href: Option<String>

MissingExteriorShell

Returned when an operation requires an exterior shell but the solid has none.

UnresolvedShellReference

Returned when a shell property carries only an xlink:href reference and the referenced geometry object has not been resolved into an inline object.

href is the reference value if one was present, or None if the property has neither an inline object nor a reference.

Fields

href: Option<String>

TriangulationNotSupported

Returned when triangulate is called on a geometry type that cannot produce a surface (e.g. Point, MultiCurve).

geometry names the concrete variant that was encountered.

Fields

geometry: &'static str

InvalidAttributeValue

Returned when an attribute held a value that could not be parsed into its expected type (e.g. an xlink:show/xlink:actuate value outside the enumeration defined by the XLink specification).

attribute names the attribute (e.g. "xlink:show"); value is the raw string that was supplied.

Fields

attribute: &'static str

value: String

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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, f: &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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Error