Struct std::fs::DirEntry

1.0.0 · source ·
pub struct DirEntry(_);
Expand description

ReadDir 迭代器返回的条目。

DirEntry 的实例表示文件系统上目录内的一个条目。 可以通过方法检查每个条目,以通过全平台扩展 traits 了解完整路径或可能的其他元数据。

特定于平台的行为

在 Unix 上,DirEntry 结构体包含对打开目录的内部引用。 即使在 ReadDir 迭代器丢弃之后,持有 DirEntry 对象也会消耗文件句柄。

注意这个 将来可能会发生变化

Implementations§

source§

impl DirEntry

source

pub fn path(&self) -> PathBuf

返回此条目表示的文件的完整路径。

通过将 read_dir 的原始路径与该条目的文件名连接起来,可以创建完整路径。

Examples
use std::fs;

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

打印输出如下:

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

当然,确切的文本取决于 . 中包含的文件。

1.1.0 · source

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

返回此条目指向的文件的元数据。

如果此函数指向符号链接,则该函数将不会遍历符号链接。要遍历符号链接,请使用 fs::metadatafs::File::metadata

特定于平台的行为

在 Windows 上,此函数的调用很便宜 (不需要额外的系统调用),但是在 Unix 平台上,此函数等效于在路径上调用 symlink_metadata

Examples
use std::fs;

if let Ok(entries) = fs::read_dir(".") {
    for entry in entries {
        if let Ok(entry) = entry {
            // 在此,`entry` 是 `DirEntry`。
            if let Ok(metadata) = entry.metadata() {
                // 现在,让我们显示条目的权限!
                println!("{:?}: {:?}", entry.path(), metadata.permissions());
            } else {
                println!("Couldn't get metadata for {:?}", entry.path());
            }
        }
    }
}
Run
1.1.0 · source

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

返回此条目指向的文件的文件类型。

如果此函数指向符号链接,则该函数将不会遍历符号链接。

特定于平台的行为

在 Windows 和大多数 Unix 平台上,此函数是免费的 (不需要额外的系统调用),但是某些 Unix 平台可能需要与 symlink_metadata 等效的调用才能了解目标文件类型。

Examples
use std::fs;

if let Ok(entries) = fs::read_dir(".") {
    for entry in entries {
        if let Ok(entry) = entry {
            // 在此,`entry` 是 `DirEntry`。
            if let Ok(file_type) = entry.file_type() {
                // 现在,让我们显示条目的文件类型!
                println!("{:?}: {:?}", entry.path(), file_type);
            } else {
                println!("Couldn't get file type for {:?}", entry.path());
            }
        }
    }
}
Run
1.1.0 · source

pub fn file_name(&self) -> OsString

返回此目录条目的裸文件名,不包含任何其他前导路径组件。

Examples
use std::fs;

if let Ok(entries) = fs::read_dir(".") {
    for entry in entries {
        if let Ok(entry) = entry {
            // 在此,`entry` 是 `DirEntry`。
            println!("{:?}", entry.file_name());
        }
    }
}
Run

Trait Implementations§

1.13.0 · source§

impl Debug for DirEntry

source§

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

使用给定的格式化程序格式化该值。 Read more
1.1.0 · source§

impl DirEntryExt for DirEntry

Available on Unix only.
source§

fn ino(&self) -> u64

返回所包含的 dirent 结构中的底层 d_ino 字段。 Read more
source§

impl DirEntryExt for DirEntry

Available on WASI only.
source§

fn ino(&self) -> u64

🔬This is a nightly-only experimental API. (wasi_ext #71213)
返回 dirent_t 的底层 d_ino 字段
source§

impl DirEntryExt2 for DirEntry

Available on Unix only.
source§

fn file_name_ref(&self) -> &OsStr

🔬This is a nightly-only experimental API. (dir_entry_ext2 #85573)
返回指向此条目文件名的底层 OsStr 的引用。 Read more

Auto Trait Implementations§

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

获取 selfTypeIdRead more
source§

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

source§

fn borrow(&self) -> &T

从拥有的值中一成不变地借用。 Read more
source§

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

source§

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

从拥有的值中借用。 Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

返回未更改的参数。

source§

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

source§

fn into(self) -> U

调用 U::from(self)

也就是说,这种转换是 From<T> for U 实现选择执行的任何操作。

source§

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

§

type Error = Infallible

发生转换错误时返回的类型。
source§

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

执行转换。
source§

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

§

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

发生转换错误时返回的类型。
source§

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

执行转换。