Struct Metadata

pub struct Metadata(/* private fields */);

Metadata information about a file.

Implementations

impl Metadata

pub fn file_type(&self) -> FileType

Returns the file type for this metadata.

pub fn is_dir(&self) -> bool

Returns true if this metadata is for a directory.

pub fn is_file(&self) -> bool

Returns true if this metadata is for a regular file.

pub fn is_symlink(&self) -> bool

Returns true if this metadata is for a symbolic link.

pub fn len(&self) -> u64

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

pub fn permissions(&self) -> Permissions

Returns the permissions of the file this metadata is for.

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

Returns the last modification time listed in this metadata.

Platform specific

• Windows: The returned value corresponds to the ftLastWriteTime field.
• Unix: The returned value corresponds to the mtime field.

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

Returns the last access time of this metadata.

Platform specific

• Windows: The returned value corresponds to the ftLastAccessTime field.
• Unix: The returned value corresponds to the atime field.

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

Returns the creation time listed in this metadata.

Platform specific

• Windows: The returned value corresponds to the ftCreationTime field.
• Unix: The returned value corresponds to the btime field of [libc::statx] or birthtime field.

impl Metadata

pub fn from_stat(stat: stat) -> Self

Available on Unix only.

Create from [libc::statx]

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 MetadataExt for Metadata

Available on Unix only.

fn dev(&self) -> u64

Returns the ID of the device containing the file.

fn ino(&self) -> u64

Returns the inode number.

fn mode(&self) -> u32

Returns the rights applied to this file.

fn nlink(&self) -> u64

Returns the number of hard links pointing to this file.

fn uid(&self) -> u32

Returns the user ID of the owner of this file.

fn gid(&self) -> u32

Returns the group ID of the owner of this file.

fn rdev(&self) -> u64

Returns the device ID of this file (if it is a special one).

fn size(&self) -> u64

Returns the total size of this file in bytes.

fn atime(&self) -> i64

Returns the last access time of the file, in seconds since Unix Epoch.

fn atime_nsec(&self) -> i64

Returns the last access time of the file, in nanoseconds since atime.

fn mtime(&self) -> i64

Returns the last modification time of the file, in seconds since Unix Epoch.

fn mtime_nsec(&self) -> i64

Returns the last modification time of the file, in nanoseconds since mtime.

fn ctime(&self) -> i64

Returns the last status change time of the file, in seconds since Unix Epoch.

fn ctime_nsec(&self) -> i64

Returns the last status change time of the file, in nanoseconds since ctime.

fn blksize(&self) -> u64

Returns the block size for filesystem I/O.

fn blocks(&self) -> u64

Returns the number of blocks allocated to the file, in 512-byte units.