Struct camino::Utf8DirEntry

source ·
pub struct Utf8DirEntry { /* private fields */ }
Expand description

Entries returned by the ReadDirUtf8 iterator.

An instance of Utf8DirEntry represents an entry inside of a directory on the filesystem. Each entry can be inspected via methods to learn about the full path or possibly other metadata.

Implementations§

source§

impl Utf8DirEntry

source

pub fn path(&self) -> &Utf8Path

Returns the full path to the file that this entry represents.

The full path is created by joining the original path to read_dir with the filename of this entry.

§Examples
use camino::Utf8Path;

fn main() -> std::io::Result<()> {
    for entry in Utf8Path::new(".").read_dir_utf8()? {
        let dir = entry?;
        println!("{}", dir.path());
    }
    Ok(())
}

This prints output like:

./whatever.txt
./foo.html
./hello_world.rs

The exact text, of course, depends on what files you have in ..

source

pub fn metadata(&self) -> Result<Metadata>

Returns the metadata for the file that this entry points at.

This function will not traverse symlinks if this entry points at a symlink. To traverse symlinks use Utf8Path::metadata or fs::File::metadata.

§Platform-specific behavior

On Windows this function is cheap to call (no extra system calls needed), but on Unix platforms this function is the equivalent of calling symlink_metadata on the path.

§Examples
use camino::Utf8Path;

if let Ok(entries) = Utf8Path::new(".").read_dir_utf8() {
    for entry in entries {
        if let Ok(entry) = entry {
            // Here, `entry` is a `Utf8DirEntry`.
            if let Ok(metadata) = entry.metadata() {
                // Now let's show our entry's permissions!
                println!("{}: {:?}", entry.path(), metadata.permissions());
            } else {
                println!("Couldn't get metadata for {}", entry.path());
            }
        }
    }
}
source

pub fn file_type(&self) -> Result<FileType>

Returns the file type for the file that this entry points at.

This function will not traverse symlinks if this entry points at a symlink.

§Platform-specific behavior

On Windows and most Unix platforms this function is free (no extra system calls needed), but some Unix platforms may require the equivalent call to symlink_metadata to learn about the target file type.

§Examples
use camino::Utf8Path;

if let Ok(entries) = Utf8Path::new(".").read_dir_utf8() {
    for entry in entries {
        if let Ok(entry) = entry {
            // Here, `entry` is a `DirEntry`.
            if let Ok(file_type) = entry.file_type() {
                // Now let's show our entry's file type!
                println!("{}: {:?}", entry.path(), file_type);
            } else {
                println!("Couldn't get file type for {}", entry.path());
            }
        }
    }
}
source

pub fn file_name(&self) -> &str

Returns the bare file name of this directory entry without any other leading path component.

§Examples
use camino::Utf8Path;

if let Ok(entries) = Utf8Path::new(".").read_dir_utf8() {
    for entry in entries {
        if let Ok(entry) = entry {
            // Here, `entry` is a `DirEntry`.
            println!("{}", entry.file_name());
        }
    }
}
source

pub fn into_inner(self) -> DirEntry

Returns the original fs::DirEntry within this Utf8DirEntry.

source

pub fn into_path(self) -> Utf8PathBuf

Returns the full path to the file that this entry represents.

This is analogous to path, but moves ownership of the path.

Trait Implementations§

source§

impl Debug for Utf8DirEntry

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

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

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

source§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.