Struct cap_std::fs::Metadata

pub struct Metadata { /* fields omitted */ }

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 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

pub 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

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

Formats the value using the given formatter.

impl MetadataExt for Metadata

pub fn file_attributes(&self) -> u32

Returns the value of the dwFileAttributes field of this metadata.

pub fn creation_time(&self) -> u64

Returns the value of the ftCreationTime field of this metadata.

pub fn last_access_time(&self) -> u64

Returns the value of the ftLastAccessTime field of this metadata.

pub fn last_write_time(&self) -> u64

Returns the value of the ftLastWriteTime field of this metadata.

pub fn file_size(&self) -> u64

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

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

🔬 This is a nightly-only experimental API. (windows_by_handle)

Returns the value of the dwVolumeSerialNumber field of this metadata.

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

🔬 This is a nightly-only experimental API. (windows_by_handle)

Returns the value of the nNumberOfLinks field of this metadata.

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

🔬 This is a nightly-only experimental API. (windows_by_handle)

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