1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183
// Copyright 2015 The Rust Project Developers. See the COPYRIGHT // file at the top-level directory of this distribution and at // http://rust-lang.org/COPYRIGHT. // // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your // option. This file may not be copied, modified, or distributed // except according to those terms. use boxed::Box; use clone::Clone; use error::Error as StdError; use fmt; use option::Option::{self, Some, None}; use result; use string::String; use sys; /// A type for results generated by I/O related functions where the `Err` type /// is hard-wired to `io::Error`. /// /// This typedef is generally used to avoid writing out `io::Error` directly and /// is otherwise a direct mapping to `std::result::Result`. pub type Result<T> = result::Result<T, Error>; /// The error type for I/O operations of the `Read`, `Write`, `Seek`, and /// associated traits. /// /// Errors mostly originate from the underlying OS, but custom instances of /// `Error` can be created with crafted error messages and a particular value of /// `ErrorKind`. #[derive(PartialEq, Eq, Clone, Debug)] pub struct Error { repr: Repr, } #[derive(PartialEq, Eq, Clone, Debug)] enum Repr { Os(i32), Custom(Box<Custom>), } #[derive(PartialEq, Eq, Clone, Debug)] struct Custom { kind: ErrorKind, desc: &'static str, detail: Option<String> } /// A list specifying general categories of I/O error. #[derive(Copy, PartialEq, Eq, Clone, Debug)] pub enum ErrorKind { /// The file was not found. FileNotFound, /// The file permissions disallowed access to this file. PermissionDenied, /// The connection was refused by the remote server. ConnectionRefused, /// The connection was reset by the remote server. ConnectionReset, /// The connection was aborted (terminated) by the remote server. ConnectionAborted, /// The network operation failed because it was not connected yet. NotConnected, /// The operation failed because a pipe was closed. BrokenPipe, /// A file already existed with that name. PathAlreadyExists, /// No file exists at that location. PathDoesntExist, /// The path did not specify the type of file that this operation required. /// For example, attempting to copy a directory with the `fs::copy()` /// operation will fail with this error. MismatchedFileTypeForOperation, /// The operation temporarily failed (for example, because a signal was /// received), and retrying may succeed. ResourceUnavailable, /// A parameter was incorrect in a way that caused an I/O error not part of /// this list. InvalidInput, /// The I/O operation's timeout expired, causing it to be canceled. TimedOut, /// An error returned when an operation could not be completed because a /// call to `write` returned `Ok(0)`. /// /// This typically means that an operation could only succeed if it wrote a /// particular number of bytes but only a smaller number of bytes could be /// written. WriteZero, /// This operation was interrupted Interrupted, /// Any I/O error not part of this list. Other, } impl Error { /// Creates a new custom error from a specified kind/description/detail. pub fn new(kind: ErrorKind, description: &'static str, detail: Option<String>) -> Error { Error { repr: Repr::Custom(Box::new(Custom { kind: kind, desc: description, detail: detail, })) } } /// Returns an error representing the last OS error which occurred. /// /// This function reads the value of `errno` for the target platform (e.g. /// `GetLastError` on Windows) and will return a corresponding instance of /// `Error` for the error code. pub fn last_os_error() -> Error { Error::from_os_error(sys::os::errno() as i32) } /// Creates a new instance of an `Error` from a particular OS error code. pub fn from_os_error(code: i32) -> Error { Error { repr: Repr::Os(code) } } /// Return the corresponding `ErrorKind` for this error. pub fn kind(&self) -> ErrorKind { match self.repr { Repr::Os(code) => sys::decode_error_kind(code), Repr::Custom(ref c) => c.kind, } } /// Returns a short description for this error message pub fn description(&self) -> &str { match self.repr { Repr::Os(..) => "os error", Repr::Custom(ref c) => c.desc, } } /// Returns a detailed error message for this error (if one is available) pub fn detail(&self) -> Option<String> { match self.repr { Repr::Os(code) => Some(sys::os::error_string(code)), Repr::Custom(ref s) => s.detail.clone(), } } } impl fmt::Display for Error { fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result { match self.repr { Repr::Os(code) => { let detail = sys::os::error_string(code); write!(fmt, "{} (os error {})", detail, code) } Repr::Custom(ref c) => { match **c { Custom { kind: ErrorKind::Other, desc: "unknown error", detail: Some(ref detail) } => { write!(fmt, "{}", detail) } Custom { detail: None, desc, .. } => write!(fmt, "{}", desc), Custom { detail: Some(ref detail), desc, .. } => write!(fmt, "{} ({})", desc, detail) } } } } } impl StdError for Error { fn description(&self) -> &str { match self.repr { Repr::Os(..) => "os error", Repr::Custom(ref c) => c.desc, } } }