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_tag_code].

  Example

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

pub fn get_by_ifd_tag_code(&self, ifd: usize, tag: u16) -> Option<&EntryValue>

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

ifd value range:

• 0: ifd0 (the main image)
• 1: ifd1 (thumbnail 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.

  Example

  use nom_exif::*;
  
  fn main() -> Result<()> {
      let mut parser = MediaParser::new();
       
      let ms = MediaSource::file_path("./testdata/exif.jpg")?;
      let iter: ExifIter = parser.parse(ms)?;
      let exif: Exif = iter.into();
  
      assert_eq!(exif.get_by_ifd_tag_code(0, 0x0110).unwrap(), &"vivo X90 Pro+".into());
      assert_eq!(exif.get_by_ifd_tag_code(1, 0xa002).unwrap(), &240_u32.into());
      Ok(())
  }

pub fn get_values<'b>( &self, tags: &'b [ExifTag], ) -> Vec<(&'b ExifTag, EntryValue)>

👎Deprecated since 1.5.0: please use [Self::get] or [ExifIter] instead

Get entry values for the specified tags in ifd0 (the main image).

Please note that this method will ignore errors encountered during the search and parsing process, such as missing tags or errors in parsing values, and handle them silently.

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

👎Deprecated since 1.5.0: please use [Self::get] instead

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

pub fn get_value_by_tag_code(&self, tag: u16) -> Result<Option<EntryValue>>

👎Deprecated since 1.5.0: please use [Self::get_by_tag_code] instead

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

pub fn get_gps_info(&self) -> Result<Option<GPSInfo>>

Get parsed GPS information.

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