Struct InputIoError 

pub struct InputIoError { /* private fields */ }

Details of an I/O failure reported by an input adapter.

This error is primarily intended for terminal failures such as a missing file, insufficient permissions, or a failed read, where an exact character position is usually not meaningful. Streaming inputs may be read ahead by a small lookahead window. Once an adapter reports an I/O failure, the parser reports it at its current marker; consequently, a few successfully read characters that were already buffered ahead of that marker may not be scanned or emitted.

The human-readable message is available in every build. With the std feature enabled, an instance constructed from std::io::Error also retains that original error and exposes it through InputIoError::io_error and the standard error source chain.

Equality and hashing use the portable message. The optional retained std error does not participate, so these operations have the same behavior with and without the std feature.

Implementations

impl InputIoError

pub fn from_message(message: impl Into<String>) -> Self

Create I/O error details from a portable message.

This constructor is available in no_std builds. It does not retain a typed source error.

pub fn from_io(error: Error) -> Self

Create I/O error details while retaining the original std::io::Error.

pub fn message(&self) -> &str

Return the portable human-readable error message.

pub fn io_error(&self) -> Option<&Error>

Return the retained std::io::Error, when one is available.

pub fn try_into_io_error(self) -> Result<Error, Self>

Recover the retained std::io::Error when this is its only owner.

Errors

Returns the original InputIoError when it was created from a portable message or when another clone still shares the retained error.

Trait Implementations

impl Clone for InputIoError

fn clone(&self) -> InputIoError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InputIoError

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

Formats the value using the given formatter.

impl Display for InputIoError

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

Formats the value using the given formatter.

impl Eq for InputIoError

impl Error for InputIoError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for InputIoError

Available on crate feature std only.

fn from(error: Error) -> Self

Converts to this type from the input type.

impl Hash for InputIoError

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 PartialEq for InputIoError

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

Equality operator ==.

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

Inequality operator !=.