Enum multipart::server::save::SaveResult

[−] Show declaration

pub enum SaveResult<Success, Partial> {
    Full(Success),
    Partial(Partial, PartialReason),
    Error(Error),
}

[−] Expand description

The ternary result type used for the SaveBuilder<_> API.

Variants

Full(Success)

[−] Expand description

The operation was a total success. Contained is the complete result.

Partial(Partial, PartialReason)

[−] Expand description

The operation quit partway through. Included is the partial result along with the reason.

Error(Error)

[−] Expand description

An error occurred at the start of the operation, before anything was done.

Methods

impl<M: ReadEntry> SaveResult<Entries, PartialEntries<M>>[−]

pub fn into_entries(self) -> Option<Entries>[−]

Take the Entries from self, if applicable, and discarding the error, if any.

impl<S, P> SaveResult<S, P> where
    P: Into<S>, [−]

pub fn okish(self) -> Option<S>[−]

Convert self to Option<S>; there may still have been an error.

pub fn map<T, Map>(self, map: Map) -> SaveResult<T, T> where
    Map: FnOnce(S) -> T, [−]

Map the Full or Partial values to a new type, retaining the reason in the Partial case.

pub fn into_opt_both(self) -> (Option<S>, Option<Error>)[−]

Decompose self to (Option<S>, Option<io::Error>)

pub fn into_result(self) -> Result<S>[−]

Map self to an io::Result, discarding the error in the Partial case.

pub fn into_result_strict(self) -> Result<S>[−]

Pessimistic version of into_result() which will return an error even for the Partial case.

Note: Possible Storage Leak

It's generally not a good idea to ignore the Partial case, as there may still be a partially written file on-disk. If you're not using a temporary directory (OS-managed or via TempDir) then partially written files will remain on-disk until explicitly removed which could result in excessive disk usage if not monitored closely.

Trait Implementations

impl<Success: Debug, Partial: Debug> Debug for SaveResult<Success, Partial>[+]

[+] Show hidden undocumented items

fn fmt(&self, f: &mut Formatter) -> Result[−]

Formats the value using the given formatter.