pub struct ContractAsyncWriteFailure { /* private fields */ }Expand description
Retains a whole-file failure snapshot and its operation, when admitted.
Obtain this value through crate::ContractSource::take and downcast it.
Admission failures have no operation. Execution failures retain the
operation even when it has no recovery writer. Taking this value transfers
any recovery responsibility to the caller; dropping it does not perform
asynchronous abort. Formatting never invokes a provider formatter.
§Examples
use qubit_fs::error::FsError;
use qubit_fs_testkit::ContractAsyncWriteFailure;
fn inspect_error(failure: &ContractAsyncWriteFailure) -> &FsError {
failure.error()
}Implementations§
Source§impl ContractAsyncWriteFailure
impl ContractAsyncWriteFailure
Sourcepub const fn error(&self) -> &FsError
pub const fn error(&self) -> &FsError
Returns the original filesystem error retained by the failure snapshot.
§Returns
A borrow of the contextual filesystem error.
Sourcepub const fn failure(&self) -> &AsyncWriteAllOperationFailure
pub const fn failure(&self) -> &AsyncWriteAllOperationFailure
Returns the failure’s publication state and accepted byte count snapshot.
§Returns
A borrow of the immutable failure snapshot.
Sourcepub const fn operation(&self) -> Option<&AsyncWriteAllOperation>
pub const fn operation(&self) -> Option<&AsyncWriteAllOperation>
Borrows the operation if request admission succeeded.
§Returns
Some when the request was admitted and has an operation, or None
when admission failed before an operation was created.
Sourcepub fn operation_mut(&mut self) -> Option<&mut AsyncWriteAllOperation>
pub fn operation_mut(&mut self) -> Option<&mut AsyncWriteAllOperation>
Borrows the operation for explicit recovery writer transfer or inspection.
§Returns
Some when an operation was retained, or None when admission failed.
Sourcepub fn into_parts(
self,
) -> (AsyncWriteAllOperationFailure, Option<AsyncWriteAllOperation>)
pub fn into_parts( self, ) -> (AsyncWriteAllOperationFailure, Option<AsyncWriteAllOperation>)
Transfers the failure snapshot and optional recovery operation.
§Returns
The failure facts and the operation when request admission succeeded.
Trait Implementations§
Source§impl Debug for ContractAsyncWriteFailure
impl Debug for ContractAsyncWriteFailure
Source§impl Display for ContractAsyncWriteFailure
impl Display for ContractAsyncWriteFailure
Source§impl Error for ContractAsyncWriteFailure
impl Error for ContractAsyncWriteFailure
Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
Exposes the retained write failure as the standard error source.
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
use the Display impl or to_string()