Enum Error 

pub enum Error {
    General(String),
    OutOfRange {
        name: &'static str,
        value: f64,
        min: f64,
        max: f64,
    },
    InvalidMesh {
        reason: String,
    },
    LengthMismatch {
        expected: usize,
        actual: usize,
    },
    ConvergenceFailure {
        operation: &'static str,
        iterations: usize,
        residual: f64,
    },
    IndexOutOfBounds {
        index: usize,
        len: usize,
    },
    TooFewPoints {
        required: usize,
        actual: usize,
    },
    DegenerateGeometry {
        details: String,
    },
    DimensionMismatch {
        lhs: &'static str,
        lhs_len: usize,
        rhs: &'static str,
        rhs_len: usize,
    },
    Unsupported {
        operation: &'static str,
        reason: String,
    },
    Io {
        context: &'static str,
        message: String,
    },
}

Main error type for the geometry module.

Variants

General(String)

Generic catch-all error with a human-readable message.

OutOfRange

A required parameter was out of its valid range.

Fields

name: &'static str

Name of the parameter.

value: f64

Actual value supplied.

min: f64

Inclusive lower bound.

max: f64

Inclusive upper bound.

InvalidMesh

A mesh is topologically or geometrically invalid.

Fields

reason: String

Human-readable description of the problem.

LengthMismatch

A buffer had the wrong length.

Fields

expected: usize

Expected length.

actual: usize

Actual length.

ConvergenceFailure

Numerical computation did not converge.

Fields

operation: &'static str

Name of the operation that failed.

iterations: usize

Number of iterations attempted.

residual: f64

Final residual value.

IndexOutOfBounds

An index was out of bounds for the given container.

Fields

index: usize

The invalid index.

len: usize

The length of the container.

TooFewPoints

A shape requires at least a minimum number of vertices/points.

Fields

required: usize

Minimum required.

actual: usize

Actual count.

DegenerateGeometry

A degenerate geometry was encountered (zero area, zero volume, etc.).

Fields

details: String

Description of the degenerate case.

DimensionMismatch

Two arrays that must have equal length do not.

Fields

lhs: &'static str

Name of the first array.

lhs_len: usize

Length of the first array.

rhs: &'static str

Name of the second array.

rhs_len: usize

Length of the second array.

Unsupported

A requested feature or algorithm is not supported for this input.

Fields

operation: &'static str

Name of the operation.

reason: String

Reason it is unsupported.

Io

An I/O error occurred during geometry serialization or deserialization.

Fields

context: &'static str

The operation context (e.g. “serialize heightfield”).

message: String

Human-readable message.

Implementations

impl Error

pub fn general(msg: impl Into<String>) -> Self

Create a General error from any string-like value.

pub fn out_of_range(name: &'static str, value: f64, min: f64, max: f64) -> Self

Create an OutOfRange error.

pub fn invalid_mesh(reason: impl Into<String>) -> Self

Create an InvalidMesh error.

pub fn length_mismatch(expected: usize, actual: usize) -> Self

Create a LengthMismatch error.

pub fn convergence_failure( operation: &'static str, iterations: usize, residual: f64, ) -> Self

Create a ConvergenceFailure error.

pub fn index_out_of_bounds(index: usize, len: usize) -> Self

Create an IndexOutOfBounds error.

pub fn too_few_points(required: usize, actual: usize) -> Self

Create a TooFewPoints error.

pub fn degenerate_geometry(details: impl Into<String>) -> Self

Create a DegenerateGeometry error.

pub fn dimension_mismatch( lhs: &'static str, lhs_len: usize, rhs: &'static str, rhs_len: usize, ) -> Self

Create a DimensionMismatch error.

pub fn unsupported(operation: &'static str, reason: impl Into<String>) -> Self

Create an Unsupported error.

pub fn io(context: &'static str, message: impl Into<String>) -> Self

Create an Io error.

pub fn is_general(&self) -> bool

Returns true if this is a General error.

pub fn is_length_mismatch(&self) -> bool

Returns true if this is a LengthMismatch error.

pub fn is_convergence_failure(&self) -> bool

Returns true if this is a convergence failure.

pub fn is_index_out_of_bounds(&self) -> bool

Returns true if this is an index-out-of-bounds error.

pub fn is_degenerate(&self) -> bool

Returns true if this error indicates degenerate geometry.

Trait Implementations

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, __formatter: &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.