Struct Metadata

pub struct Metadata { /* private fields */ }

Available on crate feature fs_utf8 only.

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