pub struct DirEntry(_);
Entries returned by the ReadDir
iterator.
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.
impl DirEntry
[src]
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.
use std::fs; fn main() -> std::io::Result<()> { for entry in fs::read_dir(".")? { 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 .
.
pub fn metadata(&self) -> Result<Metadata>
[src]1.1.0
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 fs::metadata
or fs::File::metadata
.
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.
use std::fs; if let Ok(entries) = fs::read_dir(".") { for entry in entries { if let Ok(entry) = entry { // Here, `entry` is a `DirEntry`. 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()); } } } }
pub fn file_type(&self) -> Result<FileType>
[src]1.1.0
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.
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.
use std::fs; if let Ok(entries) = fs::read_dir(".") { 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()); } } } }
pub fn file_name(&self) -> OsString
[src]1.1.0
Returns the bare file name of this directory entry without any other leading path component.
impl RefUnwindSafe for DirEntry
impl Send for DirEntry
impl Sync for DirEntry
impl Unpin for DirEntry
impl UnwindSafe for DirEntry
impl<T> Any for T where
T: 'static + ?Sized,
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
fn borrow(&self) -> &TⓘNotable traits for &'_ mut F
impl<'_, F> Future for &'_ mut F where
F: Unpin + Future + ?Sized,
type Output = <F as Future>::Output;
impl<'_, I> Iterator for &'_ mut I where
I: Iterator + ?Sized,
type Item = <I as Iterator>::Item;
impl<R: Read + ?Sized, '_> Read for &'_ mut R
impl<W: Write + ?Sized, '_> Write for &'_ mut W
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
fn borrow_mut(&mut self) -> &mut TⓘNotable traits for &'_ mut F
impl<'_, F> Future for &'_ mut F where
F: Unpin + Future + ?Sized,
type Output = <F as Future>::Output;
impl<'_, I> Iterator for &'_ mut I where
I: Iterator + ?Sized,
type Item = <I as Iterator>::Item;
impl<R: Read + ?Sized, '_> Read for &'_ mut R
impl<W: Write + ?Sized, '_> Write for &'_ mut W
[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.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/fs/struct.DirEntry.html