Returns the file type for this metadata.

§Examples

fnmain() -> std::io::Result<()> {usestd::fs;letmetadata = fs::metadata("foo.txt")?;println!("{:?}", metadata.file_type());Ok(())}

Returnstrue if this metadata is for a directory. Theresult is mutually exclusive to the result ofMetadata::is_file, and will be false for symlink metadataobtained fromsymlink_metadata.

§Examples

fnmain() -> std::io::Result<()> {usestd::fs;letmetadata = fs::metadata("foo.txt")?;assert!(!metadata.is_dir());Ok(())}

Returnstrue if this metadata is for a regular file. Theresult is mutually exclusive to the result ofMetadata::is_dir, and will be false for symlink metadataobtained fromsymlink_metadata.

When the goal is simply to read from (or write to) the source, the mostreliable way to test the source can be read (or written to) is to openit. Only usingis_file can break workflows likediff <( prog_a ) ona Unix-like system for example. SeeFile::open orOpenOptions::open for more information.

§Examples

usestd::fs;fnmain() -> std::io::Result<()> {letmetadata = fs::metadata("foo.txt")?;assert!(metadata.is_file());Ok(())}

Returnstrue if this metadata is for a symbolic link.

§Examples

usestd::fs;usestd::path::Path;usestd::os::unix::fs::symlink;fnmain() -> std::io::Result<()> {letlink_path = Path::new("link");    symlink("/origin_does_not_exist/", link_path)?;letmetadata = fs::symlink_metadata(link_path)?;assert!(metadata.is_symlink());Ok(())}

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

§Examples

usestd::fs;fnmain() -> std::io::Result<()> {letmetadata = fs::metadata("foo.txt")?;assert_eq!(0, metadata.len());Ok(())}

Returns the permissions of the file this metadata is for.

§Examples

usestd::fs;fnmain() -> std::io::Result<()> {letmetadata = fs::metadata("foo.txt")?;assert!(!metadata.permissions().readonly());Ok(())}

Returns the last modification time listed in this metadata.

The returned value corresponds to themtime field ofstat on Unixplatforms and theftLastWriteTime field on Windows platforms.

§Errors

This field might not be available on all platforms, and will return anErr on platforms where it is not available.

§Examples

usestd::fs;fnmain() -> std::io::Result<()> {letmetadata = fs::metadata("foo.txt")?;if letOk(time) = metadata.modified() {println!("{time:?}");    }else{println!("Not supported on this platform");    }Ok(())}

Returns the last access time of this metadata.

The returned value corresponds to theatime field ofstat on Unixplatforms and theftLastAccessTime field on Windows platforms.

Note that not all platforms will keep this field update in a file’smetadata, for example Windows has an option to disable updating thistime when files are accessed and Linux similarly hasnoatime.

§Errors

This field might not be available on all platforms, and will return anErr on platforms where it is not available.

§Examples

usestd::fs;fnmain() -> std::io::Result<()> {letmetadata = fs::metadata("foo.txt")?;if letOk(time) = metadata.accessed() {println!("{time:?}");    }else{println!("Not supported on this platform");    }Ok(())}

Returns the creation time listed in this metadata.

The returned value corresponds to thebtime field ofstatx onLinux kernel starting from to 4.11, thebirthtime field ofstat on otherUnix platforms, and theftCreationTime field on Windows platforms.

§Errors

This field might not be available on all platforms, and will return anErr on platforms or filesystems where it is not available.

§Examples

usestd::fs;fnmain() -> std::io::Result<()> {letmetadata = fs::metadata("foo.txt")?;if letOk(time) = metadata.created() {println!("{time:?}");    }else{println!("Not supported on this platform or filesystem");    }Ok(())}

Returns the argument unchanged.

CallsU::from(self).

That is, this conversion is whatever the implementation ofFrom<T> for U chooses to do.