Enum SelectionError 

pub enum SelectionError {
    EmptyProductSet,
    InvalidRange {
        start_epoch_j2000_s: f64,
        end_epoch_j2000_s: f64,
    },
    NoPriorProduct {
        requested_epoch_j2000_s: f64,
    },
    BeyondStalenessCap {
        requested_epoch_j2000_s: f64,
        source_epoch_j2000_s: f64,
        staleness_s: f64,
        max_staleness_s: f64,
    },
    InvalidProduct(String),
    InvalidPolicy {
        max_staleness_s: f64,
    },
    Overflow {
        context: &'static str,
    },
}

Error returned when no product can satisfy a request.

No degraded data is ever returned through this type: a successful selection always carries StalenessMetadata, and these variants are the only outcomes where the layer declines to produce a result.

Variants

EmptyProductSet

The product set was empty.

InvalidRange

The requested range was malformed (non-finite, or end before start).

Fields

start_epoch_j2000_s: f64

Range start, J2000 seconds.

end_epoch_j2000_s: f64

Range end, J2000 seconds.

NoPriorProduct

No product covers or precedes the requested epoch; only later products are available, so there is nothing to degrade to.

Fields

requested_epoch_j2000_s: f64

The requested epoch, J2000 seconds.

BeyondStalenessCap

The most-recent usable product is older than the staleness cap.

Fields

requested_epoch_j2000_s: f64

The requested epoch, J2000 seconds.

source_epoch_j2000_s: f64

The source epoch that would have been used, J2000 seconds.

staleness_s: f64

How stale that source is, seconds.

max_staleness_s: f64

The cap that was exceeded, seconds.

InvalidProduct(String)

A product in the set was malformed (e.g. no epochs, or an epoch that cannot be projected onto the J2000 axis), or the only prior product cannot cover the requested range even after a whole-day diurnal shift.

InvalidPolicy

The staleness policy cap was non-finite or negative. A cap that is not a finite, non-negative number of seconds cannot bound degradation: comparisons such as staleness_s > NaN are always false, which would admit arbitrarily stale data without surfacing it. The selection layer rejects such a policy rather than masking the failure it exists to catch.

Fields

max_staleness_s: f64

The rejected cap, seconds.

Overflow

An epoch computation overflowed the i64 J2000-second axis for an extreme requested range. No usable result can be produced without wrapping, so the request is declined rather than returning a wrapped epoch.

Fields

context: &'static str

Which computation overflowed.

Trait Implementations

impl Clone for SelectionError

fn clone(&self) -> SelectionError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SelectionError

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

Formats the value using the given formatter.

impl Display for SelectionError

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

Formats the value using the given formatter.

impl Error for SelectionError

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 SelectionError

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