Enum IOErrorEnum

#[non_exhaustive]
pub enum IOErrorEnum {
    Failed,
    NotFound,
    Exists,
    IsDirectory,
    NotDirectory,
    NotEmpty,
    NotRegularFile,
    NotSymbolicLink,
    NotMountableFile,
    FilenameTooLong,
    InvalidFilename,
    TooManyLinks,
    NoSpace,
    InvalidArgument,
    PermissionDenied,
    NotSupported,
    NotMounted,
    AlreadyMounted,
    Closed,
    Cancelled,
    Pending,
    ReadOnly,
    CantCreateBackup,
    WrongEtag,
    TimedOut,
    WouldRecurse,
    Busy,
    WouldBlock,
    HostNotFound,
    WouldMerge,
    FailedHandled,
    TooManyOpenFiles,
    NotInitialized,
    AddressInUse,
    PartialInput,
    InvalidData,
    DbusError,
    HostUnreachable,
    NetworkUnreachable,
    ConnectionRefused,
    ProxyFailed,
    ProxyAuthFailed,
    ProxyNeedAuth,
    ProxyNotAllowed,
    BrokenPipe,
    NotConnected,
    MessageTooLarge,
    NoSuchDevice,
    DestinationUnset,
}

Error codes returned by GIO functions.

Note that this domain may be extended in future GLib releases. In general, new error codes either only apply to new APIs, or else replace Failed in cases that were not explicitly distinguished before. You should therefore avoid writing code like

⚠️ The following code is in C ⚠️

if (g_error_matches (error, G_IO_ERROR, G_IO_ERROR_FAILED))
  {
    // Assume that this is EPRINTERONFIRE
    ...
  }

but should instead treat all unrecognized error codes the same as Failed.

See also #GPollableReturn for a cheaper way of returning WouldBlock to callers without allocating a #GError.

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.

Failed

Generic error condition for when an operation fails and no more specific #GIOErrorEnum value is defined.

NotFound

File not found.

Exists

File already exists.

IsDirectory

File is a directory.

NotDirectory

File is not a directory.

NotEmpty

File is a directory that isn’t empty.

NotRegularFile

File is not a regular file.

NotSymbolicLink

File is not a symbolic link.

NotMountableFile

File cannot be mounted.

FilenameTooLong

Filename is too many characters.

InvalidFilename

Filename is invalid or contains invalid characters.

TooManyLinks

File contains too many symbolic links.

NoSpace

No space left on drive.

InvalidArgument

Invalid argument.

PermissionDenied

Permission denied.

NotSupported

Operation (or one of its parameters) not supported

NotMounted

File isn’t mounted.

AlreadyMounted

File is already mounted.

Closed

File was closed.

Cancelled

Operation was cancelled. See #GCancellable.

Pending

Operations are still pending.

ReadOnly

File is read only.

CantCreateBackup

Backup couldn’t be created.

WrongEtag

File’s Entity Tag was incorrect.

TimedOut

Operation timed out.

WouldRecurse

Operation would be recursive.

Busy

File is busy.

WouldBlock

Operation would block.

HostNotFound

Host couldn’t be found (remote operations).

WouldMerge

Operation would merge files.

FailedHandled

Operation failed and a helper program has already interacted with the user. Do not display any error dialog.

TooManyOpenFiles

The current process has too many files open and can’t open any more. Duplicate descriptors do count toward this limit. Since 2.20

NotInitialized

The object has not been initialized. Since 2.22

AddressInUse

The requested address is already in use. Since 2.22

PartialInput

Need more input to finish operation. Since 2.24

InvalidData

The input data was invalid. Since 2.24

DbusError

A remote object generated an error that doesn’t correspond to a locally registered #GError error domain. Use g_dbus_error_get_remote_error() to extract the D-Bus error name and g_dbus_error_strip_remote_error() to fix up the message so it matches what was received on the wire. Since 2.26.

HostUnreachable

Host unreachable. Since 2.26

NetworkUnreachable

Network unreachable. Since 2.26

ConnectionRefused

Connection refused. Since 2.26

ProxyFailed

Connection to proxy server failed. Since 2.26

ProxyAuthFailed

Proxy authentication failed. Since 2.26

ProxyNeedAuth

Proxy server needs authentication. Since 2.26

ProxyNotAllowed

Proxy connection is not allowed by ruleset. Since 2.26

BrokenPipe

Broken pipe. Since 2.36

NotConnected

Transport endpoint is not connected. Since 2.44

MessageTooLarge

Message too large. Since 2.48.

NoSuchDevice

Available on crate feature v2_72 only.

No such device found. Since 2.74

DestinationUnset

Available on crate feature v2_80 only.

Destination address unset. Since 2.80

Trait Implementations

impl Clone for IOErrorEnum

fn clone(&self) -> IOErrorEnum

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for IOErrorEnum

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

Formats the value using the given formatter.

impl ErrorDomain for IOErrorEnum

fn domain() -> Quark

Returns the quark identifying the error domain.

fn code(self) -> i32

Gets the integer representation of the variant.

fn from(code: i32) -> Option<Self>

Tries to convert an integer code to an enum variant.

impl From<FileError> for IOErrorEnum

Available on crate feature v2_74 only.

fn from(e: FileError) -> Self

Converts to this type from the input type.

impl From<IOErrorEnum> for ErrorKind

fn from(kind: IOErrorEnum) -> Self

Converts to this type from the input type.

impl From<IOErrorEnum> for Value

fn from(v: IOErrorEnum) -> Self

Converts to this type from the input type.

impl<'a> FromValue<'a> for IOErrorEnum

type Checker = GenericValueTypeChecker<IOErrorEnum>

Value type checker.

unsafe fn from_value(value: &'a Value) -> Self

Get the contained value from a Value.

impl HasParamSpec for IOErrorEnum

type ParamSpec = ParamSpecEnum

type SetValue = IOErrorEnum

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str, _: IOErrorEnum) -> ParamSpecEnumBuilder<'_, IOErrorEnum>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for IOErrorEnum

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for IOErrorEnum

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

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for IOErrorEnum

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for IOErrorEnum

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

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for IOErrorEnum

fn static_type() -> Type

Returns the type identifier of Self.

impl ToValue for IOErrorEnum

fn to_value(&self) -> Value

Convert a value to a Value.

fn value_type(&self) -> Type

Returns the type identifier of self.

impl ValueType for IOErrorEnum

type Type = IOErrorEnum

Type to get the Type from.

impl Copy for IOErrorEnum

impl Eq for IOErrorEnum

impl StructuralPartialEq for IOErrorEnum