Struct Error

pub struct Error(/* private fields */);

Wrapper over errno.

The error number is an integer number set by system calls and some libc functions in case of error.

Implementations

impl Error

pub fn new(errno: i32) -> Error

Creates a new error from the given error number.

Arguments

• errno: error number used for creating the Error.

Examples

extern crate vmm_sys_util;
use vmm_sys_util::errno::Error;

let err = Error::new(libc::EIO);

pub fn last() -> Error

Returns the last occurred errno wrapped in an Error.

Calling Error::last() is the equivalent of using errno in C/C++. The result of this function only has meaning after a libc call or syscall where errno was set.

Examples

extern crate vmm_sys_util;
use vmm_sys_util::errno::Error;
// Reading from a file without permissions returns an error.
let mut path = temp_dir();
path.push("test");
let mut file = File::create(path).unwrap();
let mut buf: Vec<u8> = Vec::new();
assert!(file.read_to_end(&mut buf).is_err());

// Retrieve the error number of the previous operation using `Error::last()`:
let read_err = Error::last();
#[cfg(unix)]
assert_eq!(read_err, Error::new(libc::EBADF));
#[cfg(not(unix))]
assert_eq!(read_err, Error::new(libc::EIO));

pub fn errno(self) -> i32

Returns the raw integer value (errno) corresponding to this Error.

Examples

extern crate vmm_sys_util;
use vmm_sys_util::errno::Error;

let err = Error::new(13);
assert_eq!(err.errno(), 13);

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Error

Converts to this type from the input type.

impl PartialEq for Error

fn eq(&self, other: &Error) -> 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 Copy for Error

impl Eq for Error

impl StructuralPartialEq for Error