[][src]Struct tokio_fs::DirEntry

pub struct DirEntry(_);

Entries returned by the ReadDir stream.

This is a specialized version of std::fs::DirEntry for usage from the Tokio runtime.

An instance of DirEntry 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 through per-platform extension traits.

Methods

impl DirEntry[src]

pub fn into_std(self) -> StdDirEntry[src]

Destructures the tokio_fs::DirEntry into a std::fs::DirEntry.

pub fn path(&self) -> PathBuf[src]

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 futures::{Future, Stream};

fn main() {
    let fut = tokio_fs::read_dir(".").flatten_stream().for_each(|dir| {
        println!("{:?}", dir.path());
        Ok(())
    }).map_err(|err| { eprintln!("Error: {:?}", err); () });
    tokio::run(fut);
}

This prints output like:

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

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

pub fn file_name(&self) -> OsString[src]

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

Examples

use futures::{Future, Stream};

fn main() {
    let fut = tokio_fs::read_dir(".").flatten_stream().for_each(|dir| {
        // Here, `dir` is a `DirEntry`.
        println!("{:?}", dir.file_name());
        Ok(())
    }).map_err(|err| { eprintln!("Error: {:?}", err); () });
    tokio::run(fut);
}

pub fn poll_metadata(&self) -> Poll<Metadata, Error>[src]

Return the metadata 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 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 futures::{Future, Stream};
use futures::future::poll_fn;

fn main() {
    let fut = tokio_fs::read_dir(".").flatten_stream().for_each(|dir| {
        // Here, `dir` is a `DirEntry`.
        let path = dir.path();
        poll_fn(move || dir.poll_metadata()).map(move |metadata| {
            println!("{:?}: {:?}", path, metadata.permissions());
        })
    }).map_err(|err| { eprintln!("Error: {:?}", err); () });
    tokio::run(fut);
}

pub fn poll_file_type(&self) -> Poll<FileType, Error>[src]

Return 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 futures::{Future, Stream};
use futures::future::poll_fn;

fn main() {
    let fut = tokio_fs::read_dir(".").flatten_stream().for_each(|dir| {
        // Here, `dir` is a `DirEntry`.
        let path = dir.path();
        poll_fn(move || dir.poll_file_type()).map(move |file_type| {
            // Now let's show our entry's file type!
            println!("{:?}: {:?}", path, file_type);
        })
    }).map_err(|err| { eprintln!("Error: {:?}", err); () });
    tokio::run(fut);
}

Trait Implementations

impl Debug for DirEntry[src]

impl DirEntryExt for DirEntry[src]

Auto Trait Implementations

impl RefUnwindSafe for DirEntry

impl Send for DirEntry

impl Sync for DirEntry

impl Unpin for DirEntry

impl UnwindSafe for DirEntry

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

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

The type returned in the event of a conversion error.