Struct WriteAllFailure 

pub struct WriteAllFailure { /* private fields */ }

A whole-file write failure retaining the recoverable writer when available.

Examples

use qubit_fs::error::{FsError, FsErrorKind, FsOperation};
use qubit_fs::write::{WriteAllFailure, WriteFailureState};

assert!(std::any::type_name::<WriteAllFailure>().contains("WriteAllFailure"));
let error = FsError::new(FsErrorKind::Io, FsOperation::Write, "failed");
assert_eq!(WriteFailureState::NotPublished, WriteFailureState::NotPublished);
assert_eq!(FsOperation::Write, error.operation());

Implementations

impl WriteAllFailure

pub const fn error(&self) -> &FsError

Returns the causal filesystem error.

pub const fn state(&self) -> WriteFailureState

Returns publication certainty at the original failure, even after recovery.

pub const fn written_bytes(&self) -> u64

Returns the original acknowledged byte count, excluding uncertain writes.

pub fn take_recovery(&mut self) -> Option<WriterRecovery>

Transfers the retained session without changing the failure snapshot.

pub fn recovery(&self) -> Option<&WriterRecovery>

Returns the retained writer, if opening had completed.

pub fn recovery_mut(&mut self) -> Option<&mut WriterRecovery>

Returns a mutable retained writer for explicit recovery.

pub fn into_parts( self, ) -> (FsError, WriteFailureState, u64, Option<WriterRecovery>)

Returns the causal error and optional writer.

Returns

The original error, publication state, confirmed byte count, and optional retained writer.

Trait Implementations

impl Debug for WriteAllFailure

fn fmt(&self, formatter: &mut Formatter<'_>) -> FmtResult

Formats the causal error and whether recovery is available.

impl Display for WriteAllFailure

fn fmt(&self, formatter: &mut Formatter<'_>) -> FmtResult

Formats the causal failure without exposing writer internals.

impl Error for WriteAllFailure

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

Returns the underlying filesystem error.

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.