Struct Metadata

pub struct Metadata { /* private fields */ }

Metadata information about a file.

This corresponds to std::fs::Metadata.

We need to define our own version because the libstd `Metadata` doesn't have a public constructor that we can use.

Implementations

impl Metadata

pub fn from_file(file: &File) -> Result<Metadata, Error>

Constructs a new instance of Self from the given std::fs::File.

pub fn from_just_metadata(std: Metadata) -> Metadata

Constructs a new instance of Self from the given std::fs::Metadata.

As with the comments in std::fs::Metadata::volume_serial_number and nearby functions, some fields of the resulting metadata will be None.

pub const fn file_type(&self) -> FileType

Returns the file type for this metadata.

This corresponds to std::fs::Metadata::file_type.

pub fn is_dir(&self) -> bool

Returns true if this metadata is for a directory.

This corresponds to std::fs::Metadata::is_dir.

pub fn is_file(&self) -> bool

Returns true if this metadata is for a regular file.

This corresponds to std::fs::Metadata::is_file.

pub fn is_symlink(&self) -> bool

Returns true if this metadata is for a symbolic link.

This corresponds to std::fs::Metadata::is_symlink.

pub const fn len(&self) -> u64

Returns the size of the file, in bytes, this metadata is for.

This corresponds to std::fs::Metadata::len.

pub fn permissions(&self) -> Permissions

Returns the permissions of the file this metadata is for.

This corresponds to std::fs::Metadata::permissions.

pub fn modified(&self) -> Result<SystemTime, Error>

Returns the last modification time listed in this metadata.

This corresponds to std::fs::Metadata::modified.

pub fn accessed(&self) -> Result<SystemTime, Error>

Returns the last access time of this metadata.

This corresponds to std::fs::Metadata::accessed.

pub fn created(&self) -> Result<SystemTime, Error>

Returns the creation time listed in this metadata.

This corresponds to std::fs::Metadata::created.

Trait Implementations

impl Clone for Metadata

fn clone(&self) -> Metadata

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Metadata

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

Formats the value using the given formatter.

impl MetadataExt for Metadata

Available on Windows only.

fn file_attributes(&self) -> u32

Returns the value of the dwFileAttributes field of this metadata.

fn creation_time(&self) -> u64

Returns the value of the ftCreationTime field of this metadata.

fn last_access_time(&self) -> u64

Returns the value of the ftLastAccessTime field of this metadata.

fn last_write_time(&self) -> u64

Returns the value of the ftLastWriteTime field of this metadata.

fn file_size(&self) -> u64

Returns the value of the nFileSize{High,Low} fields of this metadata.

fn volume_serial_number(&self) -> Option<u32>

Available on windows_by_handle only.

Returns the value of the dwVolumeSerialNumber field of this metadata.

fn number_of_links(&self) -> Option<u32>

Available on windows_by_handle only.

Returns the value of the nNumberOfLinks field of this metadata.

fn file_index(&self) -> Option<u64>

Available on windows_by_handle only.

Returns the value of the nFileIndex{Low,High} fields of this metadata.