Enum Error

#[non_exhaustive]
pub enum Error {
    InvalidFormat(&'static str),
    Io(Error),
    NotFound(&'static str),
    BlankValue(&'static str),
    TooBig(&'static str),
    NotSupported(&'static str),
    UnexpectedValue(&'static str),
    PartialResult(PartialResult),
}

An error returned when parsing of Exif data fails.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidFormat(&'static str)

Input data was malformed or truncated.

Io(Error)

Input data could not be read due to an I/O error and a std::io::Error value is associated with this variant.

NotFound(&'static str)

Exif attribute information was not found in an image file such as JPEG.

BlankValue(&'static str)

The value of the field is blank. Some fields have blank values whose meanings are defined as “unknown”. Such a blank value should be treated the same as the absence of the field.

TooBig(&'static str)

Field values or image data are too big to encode.

NotSupported(&'static str)

The field type is not supported and cannnot be encoded.

UnexpectedValue(&'static str)

The field has an unexpected value.

PartialResult(PartialResult)

Partially-parsed result and errors. This can be returned only when Reader::continue_on_error is enabled.

Implementations

impl Error

pub fn distill_partial_result<F>(self, f: F) -> Result<Exif, Self>

where F: FnOnce(Vec<Error>),

Extracts Exif and Vec<Error> from Error::PartialResult.

If self is Error::PartialResult, ignored errors are passed to f as Vec<Error> and partially-parsed result is retuend in Ok. Otherwise, Err(self) is returned.

Examples found in repository

examples/dumpexif.rs (lines 53-56)

fn dump_file(path: &Path) -> Result<(), exif::Error> {
    let file = File::open(path)?;

    // To parse strictly:
    // let exif = exif::Reader::new()
    //     .read_from_container(&mut BufReader::new(&file))?;

    // To parse with continue-on-error mode:
    let exif = exif::Reader::new()
        .continue_on_error(true)
        .read_from_container(&mut BufReader::new(&file))
        .or_else(|e| e.distill_partial_result(|errors| {
            eprintln!("{}: {} warning(s)", path.display(), errors.len());
            errors.iter().for_each(|e| eprintln!("  {}", e));
        }))?;

    println!("{}", path.display());
    for f in exif.fields() {
        println!("  {}/{}: {}",
                 f.ifd_num.index(), f.tag,
                 f.display_value().with_unit(&exif));
        println!("      {:?}", f.value);
    }
    Ok(())
}

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<&'static str> for Error

fn from(err: &'static str) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Error

Converts to this type from the input type.