#[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
InvalidComposition(CompositionError)
The static bit composition request is invalid.
Io(Error)
An input/output operation failed.
UnknownFormat
The waveform format could not be detected.
UnknownBackend
The requested backend name is unknown.
NoBackend
No available backend can read the waveform format.
The selected backend is known but unavailable at runtime.
For example, a required dependency, license, or vendor library is missing.
BackendDoesNotSupport
The explicitly selected backend cannot read the detected waveform format.
UnsupportedInput
The selected backend cannot read the supplied 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
Malformed
The recognized waveform data is malformed.
Fields
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
InvalidSelectionIndex
A driver or readable subset index is outside its selection.
InvalidQueryTime
A query-context read is outside the current and preceding tick window.
TraceCoverage
A saved trace does not cover the requested tick.
This is distinct from a covered tick with no known persistent value.
Fields
InvalidSignal
The signal belongs to a different hierarchy or waveform.
UnsupportedSignal
The hierarchy exposes the signal, but its value class is unsupported for queries.
Backend
The underlying reader failed in a way not covered by a more specific category.
Trait Implementations§
Source§impl Error for Error
impl Error for Error
Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
use the Display impl or to_string()