Struct Metadata

pub struct Metadata { /* private fields */ }

A container for the UnixFs metadata, which can be present at the root of the file, directory, or symlink trees.

Implementations

impl Metadata

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

Returns the full file mode, if one has been specified.

The full file mode is originally read through st_mode field of stat struct defined in sys/stat.h and its defining OpenGroup standard. The lowest 3 bytes correspond to read, write, and execute rights per user, group, and other, while the 4th byte determines sticky bits, set user id or set group id. The following two bytes correspond to the different file types, as defined by the same OpenGroup standard: https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/sys_stat.h.html

pub fn mtime(&self) -> Option<(i64, u32)>

Returns the raw timestamp of last modification time, if specified.

The timestamp is (seconds, nanos) - similar to core::time::Duration, with the exception of allowing seconds to be negative. The seconds are calculated from 1970-01-01 00:00:00 or the common “unix epoch”.

pub fn mtime_as_filetime(&self) -> Option<FileTime>

Returns the mtime metadata as a FileTime. Enabled only in the filetime feature.

Trait Implementations

impl AsRef<Metadata> for FileVisit

fn as_ref(&self) -> &Metadata

Converts this type into a shared reference of the (usually inferred) input type.

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

Formats the value using the given formatter.

impl Default for Metadata

fn default() -> Metadata

Returns the “default value” for a type.

impl<'a> From<&'a Data<'_>> for Metadata

fn from(data: &'a UnixFs<'_>) -> Self

Converts to this type from the input type.

impl PartialEq for Metadata

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Metadata

impl StructuralPartialEq for Metadata