Enum std::io::ErrorKind

#[non_exhaustive]
pub enum ErrorKind {
    NotFound,
    PermissionDenied,
    ConnectionRefused,
    ConnectionReset,
    HostUnreachable,
    NetworkUnreachable,
    ConnectionAborted,
    NotConnected,
    AddrInUse,
    AddrNotAvailable,
    NetworkDown,
    BrokenPipe,
    AlreadyExists,
    WouldBlock,
    NotADirectory,
    IsADirectory,
    DirectoryNotEmpty,
    ReadOnlyFilesystem,
    FilesystemLoop,
    StaleNetworkFileHandle,
    InvalidInput,
    InvalidData,
    TimedOut,
    WriteZero,
    StorageFull,
    NotSeekable,
    FilesystemQuotaExceeded,
    FileTooLarge,
    ResourceBusy,
    ExecutableFileBusy,
    Deadlock,
    CrossesDevices,
    TooManyLinks,
    FilenameTooLong,
    ArgumentListTooLong,
    Interrupted,
    Unsupported,
    UnexpectedEof,
    OutOfMemory,
    Other,
    // some variants omitted
}

一个列表，指定 I/O 错误的常规类别。

此列表旨在随着时间的增长而增长，不建议对其进行详尽的匹配。

与 io::Error 类型一起使用。

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NotFound

找不到实体，通常是文件。

PermissionDenied

该操作缺少完成操作所需的权限。

ConnectionRefused

远程服务器拒绝了连接。

ConnectionReset

连接已由远程服务器重置。

HostUnreachable

🔬 This is a nightly-only experimental API. (io_error_more #86442)

远程主机不可访问。

NetworkUnreachable

🔬 This is a nightly-only experimental API. (io_error_more #86442)

无法访问包含远程主机的网络。

ConnectionAborted

(terminated) 连接被远程服务器中止。

NotConnected

网络操作失败，因为尚未连接。

AddrInUse

无法绑定套接字地址，因为该地址已在其他地方使用。

AddrNotAvailable

请求了不存在的接口，或者请求的地址不是本地的。

NetworkDown

🔬 This is a nightly-only experimental API. (io_error_more #86442)

系统的网络已关闭。

BrokenPipe

操作失败，因为管道已关闭。

AlreadyExists

一个实体已经存在，通常是一个文件。

WouldBlock

该操作需要阻止才能完成，但是请求阻止操作不会发生。

NotADirectory

🔬 This is a nightly-only experimental API. (io_error_more #86442)

出乎意料的是，文件系统对象不是目录。

例如，指定了一个文件系统路径，其中一个中间目录组件实际上是一个普通文件。

IsADirectory

🔬 This is a nightly-only experimental API. (io_error_more #86442)

出乎意料的是，文件系统对象是一个目录。

当需要一个非目录时指定了一个目录。

DirectoryNotEmpty

🔬 This is a nightly-only experimental API. (io_error_more #86442)

在需要空目录的地方指定了一个非空目录。

ReadOnlyFilesystem

🔬 This is a nightly-only experimental API. (io_error_more #86442)

文件系统或存储介质是只读的，但尝试了写入操作。

FilesystemLoop

🔬 This is a nightly-only experimental API. (io_error_more #86442)

在文件系统或 IO 子系统中循环； 通常，太多级别的符号链接。

有一个循环 (或过长的链) 解析文件系统对象或文件 IO 对象。

在 Unix 上，这通常是符号链接循环的结果； 或者，超过系统特定的符号链接遍历深度限制。

StaleNetworkFileHandle

🔬 This is a nightly-only experimental API. (io_error_more #86442)

陈旧的网络文件句柄。

对于某些网络文件系统，尤其是 NFS，打开的文件 (或目录) 可能会因网络或服务器问题而失效。

InvalidInput

参数不正确。

InvalidData

遇到对该操作无效的数据。

与 InvalidInput 不同，这通常意味着操作参数有效，但是该错误是由格式错误的输入数据引起的。

例如，如果文件的内容无效 UTF-8，则将文件读入字符串的函数将出现 InvalidData 错误。

TimedOut

I/O 操作的超时已到期，导致其被取消。

WriteZero

由于调用 write 返回 Ok(0) 而无法完成操作时，返回错误。

这通常意味着操作只有在写入特定数量的字节后才能成功，但是只能写入较少的字节数才能成功。

StorageFull

🔬 This is a nightly-only experimental API. (io_error_more #86442)

底层存储 (通常是文件系统) 已满。

这不包括超出配额的错误。

NotSeekable

🔬 This is a nightly-only experimental API. (io_error_more #86442)

Seek 在不可搜索的文件上。

尝试在不适合搜索的打开文件句柄上进行搜索 - 例如，在 Unix 上，使用 File::open 打开的命名管道。

FilesystemQuotaExceeded

🔬 This is a nightly-only experimental API. (io_error_more #86442)

超出了文件系统配额。

FileTooLarge

🔬 This is a nightly-only experimental API. (io_error_more #86442)

文件大于允许或支持。

这可能源于底层文件系统或文件访问 API 的硬限制，或源于管理强加的资源限制。 简单的磁盘已满，超出配额，都有自己的错误。

ResourceBusy

🔬 This is a nightly-only experimental API. (io_error_more #86442)

资源繁忙。

ExecutableFileBusy

🔬 This is a nightly-only experimental API. (io_error_more #86442)

可执行文件正忙。

试图写入一个文件，该文件也用作正在运行的程序。 (并非所有操作系统都检测到这种情况。)

Deadlock

🔬 This is a nightly-only experimental API. (io_error_more #86442)

死锁 (avoided)。

文件锁定操作会导致死锁。 这种情况通常是在尽力而为的基础上检测到的。

CrossesDevices

🔬 This is a nightly-only experimental API. (io_error_more #86442)

跨设备或跨文件系统 (hard) 链接或重命名。

TooManyLinks

🔬 This is a nightly-only experimental API. (io_error_more #86442)

太多 (hard) 链接到同一个文件系统对象。

文件系统不支持对同一个文件建立如此多的硬链接。

FilenameTooLong

🔬 This is a nightly-only experimental API. (io_error_more #86442)

文件名太长。

该限制可能来自底层文件系统或 API，或者是管理上强加的资源限制。

ArgumentListTooLong

🔬 This is a nightly-only experimental API. (io_error_more #86442)

程序参数列表太长。

尝试运行外部程序时，会超出系统或进程对参数大小的限制。

Interrupted

该操作被中断。

通常可以重试中断的操作。

Unsupported

此平台不支持此操作。

这意味着操作永远不会成功。

UnexpectedEof

由于过早到达 “文件结尾” 而无法完成操作时，返回错误。

通常，这意味着操作只有在读取特定数量的字节后才能成功，但是只能读取较少的字节。

OutOfMemory

操作无法完成，因为它未能分配足够的内存。

Other

不属于任何其他 I/O 错误类型的自定义错误。

这可用于构建您自己的不匹配任何 ErrorKind 的 Error。

标准库不使用此 ErrorKind。

标准库中不属于任何 I/O 错误类型的错误无法 匹配，并且只会匹配通配符 (_) 模式。

可能会在 future 中为其中一些添加新的 ErrorKind。

Trait Implementations

impl Clone for ErrorKind

fn clone(&self) -> ErrorKind

返回值的副本。

fn clone_from(&mut self, source: &Self)

从 source 执行复制分配。

impl Debug for ErrorKind

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

使用给定的格式化程序格式化该值。

impl From<ErrorKind> for Error

旨在用于未暴露给用户的错误，因为分配到堆上 (通过 Error::new 进行常规构建) 的代价太高了。

fn from(kind: ErrorKind) -> Error

将 ErrorKind 转换为 Error。

此转换使用错误类型的简单表示来分配新错误。

Examples

use std::io::{Error, ErrorKind};

let not_found = ErrorKind::NotFound;
let error = Error::from(not_found);
assert_eq!("entity not found", format!("{}", error));

impl Hash for ErrorKind

fn hash<__H: Hasher>(&self, state: &mut __H)

将该值输入给定的 Hasher。

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

将这种类型的切片送入给定的 Hasher 中。

impl Ord for ErrorKind

fn cmp(&self, other: &ErrorKind) -> Ordering

此方法返回 self 和 other 之间的 Ordering。

fn max(self, other: Self) -> Self

比较并返回两个值中的最大值。

fn min(self, other: Self) -> Self

比较并返回两个值中的最小值。

fn clamp(self, min: Self, max: Self) -> Self

将值限制在某个时间间隔内。

impl PartialEq<ErrorKind> for ErrorKind

fn eq(&self, other: &ErrorKind) -> bool

此方法测试 self 和 other 值是否相等，并由 == 使用。

fn ne(&self, other: &Rhs) -> bool

此方法测试 !=。

impl PartialOrd<ErrorKind> for ErrorKind

fn partial_cmp(&self, other: &ErrorKind) -> Option<Ordering>

如果存在，则此方法返回 self 和 other 值之间的顺序。

fn lt(&self, other: &Rhs) -> bool

此方法测试的内容少于 (对于 self 和 other)，并且由 < 操作员使用。

fn le(&self, other: &Rhs) -> bool

此方法测试小于或等于 (对于 self 和 other)，并且由 <= 运算符使用。

fn gt(&self, other: &Rhs) -> bool

此方法测试大于 (对于 self 和 other)，并且由 > 操作员使用。

fn ge(&self, other: &Rhs) -> bool

此方法测试是否大于或等于 (对于 self 和 other)，并且由 >= 运算符使用。

impl Copy for ErrorKind

impl Eq for ErrorKind

impl StructuralEq for ErrorKind

impl StructuralPartialEq for ErrorKind