pub struct FileType(_);
Expand description
A structure representing a type of file with accessors for each file type.
It is returned by Metadata::file_type
method.
Implementations
Tests whether this file type represents a directory. The
result is mutually exclusive to the results of
is_file
and is_symlink
; only zero or one of these
tests may pass.
Examples
fn main() -> std::io::Result<()> {
use std::fs;
let metadata = fs::metadata("foo.txt")?;
let file_type = metadata.file_type();
assert_eq!(file_type.is_dir(), false);
Ok(())
}
RunTests whether this file type represents a regular file.
The result is mutually exclusive to the results of
is_dir
and is_symlink
; only zero or one of these
tests may pass.
When the goal is simply to read from (or write to) the source, the most
reliable way to test the source can be read (or written to) is to open
it. Only using is_file
can break workflows like diff <( prog_a )
on
a Unix-like system for example. See File::open
or
OpenOptions::open
for more information.
Examples
fn main() -> std::io::Result<()> {
use std::fs;
let metadata = fs::metadata("foo.txt")?;
let file_type = metadata.file_type();
assert_eq!(file_type.is_file(), true);
Ok(())
}
RunTests whether this file type represents a symbolic link.
The result is mutually exclusive to the results of
is_dir
and is_file
; only zero or one of these
tests may pass.
The underlying Metadata
struct needs to be retrieved
with the fs::symlink_metadata
function and not the
fs::metadata
function. The fs::metadata
function
follows symbolic links, so is_symlink
would always
return false
for the target file.
Examples
use std::fs;
fn main() -> std::io::Result<()> {
let metadata = fs::symlink_metadata("foo.txt")?;
let file_type = metadata.file_type();
assert_eq!(file_type.is_symlink(), false);
Ok(())
}
RunTrait Implementations
Returns true
if this file type is a block device.
Returns true
if this file type is a character device.
Returns true
if this file type is a socket datagram.
Returns true
if this file type is a socket stream.
windows_file_type_ext
)Returns true
if this file type is a symbolic link that is also a directory.
windows_file_type_ext
)Returns true
if this file type is a symbolic link that is also a file.