Struct FileIdentity 

pub struct FileIdentity { /* private fields */ }

Available on crate feature std only.

Which file a path or handle names, and whether it changed.

On Unix it is device, inode, size, modification and change time; on Windows volume serial number, 128-bit file ID, size and last write time; elsewhere size and modification time. Two snapshots differ when any field differs, so a replacement with an older timestamp is a change too.

Build it with Self::of_path or Self::of_file. Self::from_metadata has no file ID on Windows, so there it tells files apart by size and last write time only, and that time advances in timer ticks (about 15.6 ms): a same-size replacement renamed in within one tick looks unchanged. Only compare identities built the same way.

A same-size in-place rewrite within one timestamp tick is not visible on any platform, nor is a same-size replacement within one tick on a Windows file system without file IDs (such as FAT).

Implementations

impl FileIdentity

pub fn of_path(path: impl AsRef<Path>) -> Result<FileIdentity, Error>

Snapshot the identity of the file path names now, following symlinks.

Errors

Returns the I/O error of opening or querying path.

pub fn of_file(file: &File) -> Result<FileIdentity, Error>

Snapshot the identity of the open file file.

Errors

Returns the I/O error of querying file.

pub fn from_metadata(metadata: &Metadata) -> FileIdentity

Snapshot the identity fields of metadata.

On Windows this leaves out the file ID, which metadata does not carry; see the type docs.

pub fn size(&self) -> u64

The file size in bytes at the time of the snapshot.

Trait Implementations

impl Clone for FileIdentity

fn clone(&self) -> FileIdentity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for FileIdentity

impl Debug for FileIdentity

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

Formats the value using the given formatter.

impl Eq for FileIdentity

impl From<&Metadata> for FileIdentity

fn from(metadata: &Metadata) -> FileIdentity

Converts to this type from the input type.

impl Hash for FileIdentity

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for FileIdentity

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FileIdentity