Struct PersistError 

pub struct PersistError { /* private fields */ }

Available on crate feature fs only.

A failed StoredFile::persist: the error, and the upload, untouched, so the caller can try another name (D-154). Converting it into a FormError (as ? does) drops the file, which deletes it.

Examples

fn save(file: form_net::StoredFile, dest: &std::path::Path) -> Result<(), form_net::FormError> {
    file.persist(dest)?; // on failure the file is dropped and deleted
    Ok(())
}

Implementations

impl PersistError

pub const fn error(&self) -> FormError

Why persist failed.

Examples

let body = b"--X\r\nContent-Disposition: form-data; name=f; filename=a.txt\r\n\r\nhello\r\n--X--";
let mut upload = form_net::read_multipart(b"multipart/form-data; boundary=X", &body[..])?;
std::fs::write(dir.join("a.txt"), b"taken")?;
let e = upload.take_file("f").unwrap().persist(&dir.join("a.txt")).unwrap_err();
assert_eq!(e.error().code(), "store.destination_exists");

pub fn into_file(self) -> StoredFile

The upload, to persist under another name.

Examples

let body = b"--X\r\nContent-Disposition: form-data; name=f; filename=a.txt\r\n\r\nhello\r\n--X--";
let mut upload = form_net::read_multipart(b"multipart/form-data; boundary=X", &body[..])?;
std::fs::write(dir.join("a.txt"), b"taken")?;
let e = upload.take_file("f").unwrap().persist(&dir.join("a.txt")).unwrap_err();
e.into_file().persist(&dir.join("b.txt"))?;
assert_eq!(std::fs::read(dir.join("b.txt"))?, b"hello");

Trait Implementations

impl Debug for PersistError

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

Formats the value using the given formatter.

impl Display for PersistError

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

Formats the value using the given formatter.

impl Error for PersistError

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

Returns the lower-level source of this error, if any.

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.

impl From<PersistError> for FormError

fn from(e: PersistError) -> FormError

Converts to this type from the input type.