Skip to main content

Error

Enum Error 

Source
#[non_exhaustive]
pub enum Error {
Show 17 variants InvalidComposition(CompositionError), Io(Error), UnknownFormat, UnknownBackend { backend: String, }, NoBackend { format: Format, }, BackendUnavailable { backend: String, message: String, }, BackendDoesNotSupport { backend: String, format: Format, }, UnsupportedInput { backend: String, input: InputKind, }, UnsupportedFeature { format: Format, backend: String, operation: &'static str, message: String, }, Malformed { format: Format, backend: String, message: String, }, NonAsciiString { format: Format, backend: String, time: Time, }, InvalidSelectionIndex { index: usize, len: usize, }, InvalidQueryTime { requested: Time, current: Time, }, TraceCoverage { requested: Time, range: TimeRange, }, InvalidSignal { signal: Signal, }, UnsupportedSignal { signal: Signal, }, Backend { backend: String, operation: &'static str, message: String, },
}
Expand description

Errors and input kinds used by path, hierarchy, slicing, and waveform operations. Errors and input kinds used by path, hierarchy, slicing, and waveform operations. Errors and input kinds used by path, hierarchy, slicing, and waveform operations. An error that occurs while opening or querying a waveform.

Error categories help you choose a recovery action. For I/O errors, check the path, permissions, or filesystem. An unavailable backend may need a runtime library or license. Unsupported formats and input kinds need a different reader. Error::UnsupportedFeature identifies a source or query support limit. Unknown SDK failures remain Error::Backend; diagnostic text is not a stable recovery code. LookupError and SliceError separately describe metadata resolution and projection errors.

§Failure contract

Failures reported by a backend return this type. Ondas does not intercept upstream reader panics. See the reader limits. Empty results do not represent errors. If no persistent state is known, the result is Sample::Missing. If no event is observed, the occurrence count is zero. If no changes occur, the trace change list is empty. Invalid handles and unsupported values remain errors.

A scan may have delivered observations before a late backend error. Owned sample and trace queries return no partial result.

Variants (Non-exhaustive)§

This enum is marked as 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.
§

InvalidComposition(CompositionError)

The static bit composition request is invalid.

§

Io(Error)

An input/output operation failed.

Tuple Fields

§0: Error

The underlying input/output error.

§

UnknownFormat

The waveform format could not be detected.

§

UnknownBackend

The requested backend name is unknown.

Fields

§backend: String

The requested backend name.

§

NoBackend

No available backend can read the waveform format.

Fields

§format: Format

The detected waveform format.

§

BackendUnavailable

The selected backend is known but unavailable at runtime.

For example, a required dependency, license, or vendor library is missing.

Fields

§backend: String

The backend name.

§message: String

The reason the backend is unavailable.

§

BackendDoesNotSupport

The explicitly selected backend cannot read the detected waveform format.

Fields

§backend: String

The backend name.

§format: Format

The unsupported waveform format.

§

UnsupportedInput

The selected backend cannot read the supplied input kind.

Fields

§backend: String

The backend name.

§input: InputKind

The unsupported input kind.

§

UnsupportedFeature

The reader does not support a feature of the recognized source or query.

This does not establish that the source is malformed. Unsupported input kinds and signal encodings use their separate error categories.

Fields

§format: Format

The recognized source format.

§backend: String

The reader that rejected the feature.

§operation: &'static str

The operation that requires the feature.

§message: String

Diagnostic details about the support limit.

§

Malformed

The recognized waveform data is malformed.

Fields

§format: Format

The waveform format.

§backend: String

The backend that read the waveform.

§message: String

A description of the malformed data.

§

NonAsciiString

A decoded string sample contains a byte outside ASCII (0 through 127).

This is a value-support limit, not evidence of a malformed source. The failure can occur during opening or a query. Earlier callback observations remain valid; owned queries return no partial result.

Fields

§format: Format

The source format.

§backend: String

The reader that decoded the value.

§time: Time

The source tick of the rejected value.

§

InvalidSelectionIndex

A driver or readable subset index is outside its selection.

Fields

§index: usize

The rejected input position.

§len: usize

The number of entries in the selection.

§

InvalidQueryTime

A query-context read is outside the current and preceding tick window.

Fields

§requested: Time

The requested sample time.

§current: Time

The current candidate time.

§

TraceCoverage

A saved trace does not cover the requested tick.

This is distinct from a covered tick with no known persistent value.

Fields

§requested: Time

The requested sample time.

§range: TimeRange

The trace’s inclusive range, possibly empty or unbounded.

§

InvalidSignal

The signal belongs to a different hierarchy or waveform.

Fields

§signal: Signal

The invalid signal handle.

§

UnsupportedSignal

The hierarchy exposes the signal, but its value class is unsupported for queries.

Fields

§signal: Signal

The unsupported signal handle.

§

Backend

The underlying reader failed in a way not covered by a more specific category.

Fields

§backend: String

The backend name.

§operation: &'static str

The operation that failed.

§message: String

A description of the failure.

Trait Implementations§

Source§

impl Debug for Error

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for Error

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Error for Error

Source§

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

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. Read more
Source§

impl From<CompositionError> for Error

Source§

fn from(source: CompositionError) -> Self

Converts to this type from the input type.
Source§

impl From<Error> for Error

Source§

fn from(source: Error) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

§

impl !RefUnwindSafe for Error

§

impl !UnwindSafe for Error

§

impl Forget for Error

§

impl Freeze for Error

§

impl Send for Error

§

impl Sync for Error

§

impl Unpin for Error

§

impl UnsafeUnpin for Error

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.