Struct Exif 

pub struct Exif { /* private fields */ }

Represents parsed Exif information, can be converted from an ExifIter like this: let exif: Exif = iter.into().

Implementations

impl Exif

pub fn get(&self, tag: ExifTag) -> Option<&EntryValue>

Get entry value for the specified tag in ifd0 (the main image).

Note:

• The parsing error related to this tag won’t be reported by this method. Either this entry is not parsed successfully, or the tag does not exist in the input data, this method will return None.

• If you want to handle parsing error, please consider to use ExifIter.

• If you have any custom defined tag which does not exist in ExifTag, you can always get the entry value by a raw tag code, see Self::get_by_code.

  Example

  use nom_exif::*;
  
  fn main() -> Result<()> {
      let mut parser = MediaParser::new();
       
      let ms = MediaSource::open("./testdata/exif.jpg")?;
      assert_eq!(ms.kind(), MediaKind::Image);
      let iter = parser.parse_exif(ms)?;
      let exif: Exif = iter.into();
  
      assert_eq!(exif.get(ExifTag::Model).unwrap(), &"vivo X90 Pro+".into());
      Ok(())
  }

pub fn get_in(&self, ifd: IfdIndex, tag: ExifTag) -> Option<&EntryValue>

Get entry value for the specified tag in the specified ifd.

Note:

• The parsing error related to this tag won’t be reported by this method. Either this entry is not parsed successfully, or the tag does not exist in the input data, this method will return None. Use Self::errors to inspect per-entry errors.

• For raw tag codes (e.g. unrecognized tags), use Self::get_by_code.

  Example

  use nom_exif::*;
  
  fn main() -> Result<()> {
      let mut parser = MediaParser::new();
      let ms = MediaSource::open("./testdata/exif.jpg")?;
      let iter = parser.parse_exif(ms)?;
      let exif: Exif = iter.into();
  
      assert_eq!(exif.get_in(IfdIndex::MAIN, ExifTag::Model).unwrap(),
                 &"vivo X90 Pro+".into());
      Ok(())
  }

pub fn get_by_code(&self, ifd: IfdIndex, code: u16) -> Option<&EntryValue>

Get entry value for the specified raw code in the specified ifd. Used for tags not in the recognized ExifTag enum.

pub fn iter(&self) -> impl Iterator<Item = ExifEntry<'_>>

Iterate every parsed entry in every IFD.

Order is: IFD0 entries first (in HashMap order — not stable), then IFD1, etc. Filter by IFD with .iter().filter(|e| e.ifd == IfdIndex::MAIN).

pub fn gps_info(&self) -> Option<&GPSInfo>

Get parsed GPS information.

Returns None if the source had no GPSInfo IFD or if its parse failed (failures land in Self::errors).

pub fn errors(&self) -> &[(IfdIndex, TagOrCode, EntryError)]

Per-entry errors collected during From<ExifIter> conversion. Each tuple is (ifd, tag, error). Empty slice if the parse was clean.

pub fn has_embedded_media(&self) -> bool

Whether the source file carries additional embedded media that this parse path did not extract — e.g. HEIC Live Photo MOV, RAF JPEG preview.

Trait Implementations

impl Clone for Exif

fn clone(&self) -> Exif

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Exif

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

Formats the value using the given formatter.

impl From<ExifIter> for Exif

fn from(iter: ExifIter) -> Self

Converts to this type from the input type.

impl PartialEq for Exif

fn eq(&self, other: &Exif) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Exif