1
Fork 0

convert: remove FromError, use From<E> instead

This removes the FromError trait, since it can now be expressed using
the new convert::Into trait. All implementations of FromError<E> where
changed to From<E>, and `try!` was changed to use From::from instead.

Because this removes FromError, it is a breaking change, but fixing it
simply requires changing the words `FromError` to `From`, and
`from_error` to `from`.

[breaking-change]
This commit is contained in:
Sean McArthur 2015-03-30 17:56:48 -07:00
parent 9de34a84bb
commit e17f4fc1d4
10 changed files with 30 additions and 50 deletions

View file

@ -51,7 +51,7 @@ use core::prelude::*;
use core::any::Any; use core::any::Any;
use core::cmp::Ordering; use core::cmp::Ordering;
use core::default::Default; use core::default::Default;
use core::error::{Error, FromError}; use core::error::Error;
use core::fmt; use core::fmt;
use core::hash::{self, Hash}; use core::hash::{self, Hash};
use core::mem; use core::mem;
@ -322,8 +322,8 @@ impl<I: DoubleEndedIterator + ?Sized> DoubleEndedIterator for Box<I> {
impl<I: ExactSizeIterator + ?Sized> ExactSizeIterator for Box<I> {} impl<I: ExactSizeIterator + ?Sized> ExactSizeIterator for Box<I> {}
#[stable(feature = "rust1", since = "1.0.0")] #[stable(feature = "rust1", since = "1.0.0")]
impl<'a, E: Error + 'a> FromError<E> for Box<Error + 'a> { impl<'a, E: Error + 'a> From<E> for Box<Error + 'a> {
fn from_error(err: E) -> Box<Error + 'a> { fn from(err: E) -> Box<Error + 'a> {
Box::new(err) Box::new(err)
} }
} }

View file

@ -99,6 +99,13 @@ impl<'a, T: ?Sized, U: ?Sized> AsMut<U> for &'a mut T where T: AsMut<U> {
// } // }
// } // }
// From itself is always itself
impl<T> From<T> for T {
fn from(t: T) -> T {
t
}
}
// From implies Into // From implies Into
impl<T, U> Into<U> for T where U: From<T> { impl<T, U> Into<U> for T where U: From<T> {
fn into(self) -> U { fn into(self) -> U {

View file

@ -34,17 +34,6 @@
//! particular implementation, but also reveal some of its implementation for //! particular implementation, but also reveal some of its implementation for
//! debugging via `cause` chains. //! debugging via `cause` chains.
//! //!
//! # The `FromError` trait
//!
//! `FromError` is a simple trait that expresses conversions between different
//! error types. To provide maximum flexibility, it does not require either of
//! the types to actually implement the `Error` trait, although this will be the
//! common case.
//!
//! The main use of this trait is in the `try!` macro, which uses it to
//! automatically convert a given error to the error specified in a function's
//! return type.
//!
//! For example, //! For example,
//! //!
//! ``` //! ```
@ -59,14 +48,14 @@
//! Map(MapError) //! Map(MapError)
//! } //! }
//! //!
//! impl FromError<IoError> for MyError { //! impl From<IoError> for MyError {
//! fn from_error(err: IoError) -> MyError { //! fn from(err: IoError) -> MyError {
//! MyError::Io(err) //! MyError::Io(err)
//! } //! }
//! } //! }
//! //!
//! impl FromError<MapError> for MyError { //! impl From<MapError> for MyError {
//! fn from_error(err: MapError) -> MyError { //! fn from(err: MapError) -> MyError {
//! MyError::Map(err) //! MyError::Map(err)
//! } //! }
//! } //! }
@ -100,19 +89,3 @@ pub trait Error: Debug + Display {
#[stable(feature = "rust1", since = "1.0.0")] #[stable(feature = "rust1", since = "1.0.0")]
fn cause(&self) -> Option<&Error> { None } fn cause(&self) -> Option<&Error> { None }
} }
/// A trait for types that can be converted from a given error type `E`.
#[stable(feature = "rust1", since = "1.0.0")]
pub trait FromError<E> {
/// Perform the conversion.
#[stable(feature = "rust1", since = "1.0.0")]
fn from_error(err: E) -> Self;
}
// Any type is convertable from itself
#[stable(feature = "rust1", since = "1.0.0")]
impl<E> FromError<E> for E {
fn from_error(err: E) -> E {
err
}
}

View file

@ -156,7 +156,7 @@ macro_rules! debug_assert_eq {
/// Short circuiting evaluation on Err /// Short circuiting evaluation on Err
/// ///
/// `libstd` contains a more general `try!` macro that uses `FromError`. /// `libstd` contains a more general `try!` macro that uses `From<E>`.
#[macro_export] #[macro_export]
macro_rules! try { macro_rules! try {
($e:expr) => ({ ($e:expr) => ({

View file

@ -365,8 +365,8 @@ impl std::error::Error for EncoderError {
fn description(&self) -> &str { "encoder error" } fn description(&self) -> &str { "encoder error" }
} }
impl std::error::FromError<fmt::Error> for EncoderError { impl From<fmt::Error> for EncoderError {
fn from_error(err: fmt::Error) -> EncoderError { EncoderError::FmtError(err) } fn from(err: fmt::Error) -> EncoderError { EncoderError::FmtError(err) }
} }
pub type EncodeResult = Result<(), EncoderError>; pub type EncodeResult = Result<(), EncoderError>;

View file

@ -12,7 +12,7 @@
use convert::Into; use convert::Into;
use cmp::{PartialEq, Eq, PartialOrd, Ord, Ordering}; use cmp::{PartialEq, Eq, PartialOrd, Ord, Ordering};
use error::{Error, FromError}; use error::Error;
use fmt; use fmt;
use io; use io;
use iter::Iterator; use iter::Iterator;
@ -298,8 +298,8 @@ impl fmt::Display for NulError {
} }
#[stable(feature = "rust1", since = "1.0.0")] #[stable(feature = "rust1", since = "1.0.0")]
impl FromError<NulError> for io::Error { impl From<NulError> for io::Error {
fn from_error(_: NulError) -> io::Error { fn from(_: NulError) -> io::Error {
io::Error::new(io::ErrorKind::InvalidInput, io::Error::new(io::ErrorKind::InvalidInput,
"data provided contains a nul byte", None) "data provided contains a nul byte", None)
} }
@ -307,8 +307,8 @@ impl FromError<NulError> for io::Error {
#[stable(feature = "rust1", since = "1.0.0")] #[stable(feature = "rust1", since = "1.0.0")]
#[allow(deprecated)] #[allow(deprecated)]
impl FromError<NulError> for old_io::IoError { impl From<NulError> for old_io::IoError {
fn from_error(_: NulError) -> old_io::IoError { fn from(_: NulError) -> old_io::IoError {
old_io::IoError { old_io::IoError {
kind: old_io::IoErrorKind::InvalidInput, kind: old_io::IoErrorKind::InvalidInput,
desc: "data provided contains a nul byte", desc: "data provided contains a nul byte",

View file

@ -16,7 +16,7 @@ use prelude::v1::*;
use io::prelude::*; use io::prelude::*;
use cmp; use cmp;
use error::{self, FromError}; use error;
use fmt; use fmt;
use io::{self, DEFAULT_BUF_SIZE, Error, ErrorKind}; use io::{self, DEFAULT_BUF_SIZE, Error, ErrorKind};
use ptr; use ptr;
@ -264,8 +264,8 @@ impl<W> IntoInnerError<W> {
} }
#[stable(feature = "rust1", since = "1.0.0")] #[stable(feature = "rust1", since = "1.0.0")]
impl<W> FromError<IntoInnerError<W>> for Error { impl<W> From<IntoInnerError<W>> for Error {
fn from_error(iie: IntoInnerError<W>) -> Error { iie.1 } fn from(iie: IntoInnerError<W>) -> Error { iie.1 }
} }
#[stable(feature = "rust1", since = "1.0.0")] #[stable(feature = "rust1", since = "1.0.0")]

View file

@ -97,7 +97,7 @@ macro_rules! try {
($expr:expr) => (match $expr { ($expr:expr) => (match $expr {
$crate::result::Result::Ok(val) => val, $crate::result::Result::Ok(val) => val,
$crate::result::Result::Err(err) => { $crate::result::Result::Err(err) => {
return $crate::result::Result::Err($crate::error::FromError::from_error(err)) return $crate::result::Result::Err($crate::convert::From::from(err))
} }
}) })
} }

View file

@ -40,7 +40,7 @@ use boxed::Box;
use clone::Clone; use clone::Clone;
use convert::From; use convert::From;
use env; use env;
use error::{FromError, Error}; use error::Error;
use ffi::{OsString, OsStr}; use ffi::{OsString, OsStr};
use fmt; use fmt;
use iter::Iterator; use iter::Iterator;

View file

@ -11,7 +11,7 @@
use prelude::v1::*; use prelude::v1::*;
use cell::UnsafeCell; use cell::UnsafeCell;
use error::{Error, FromError}; use error::{Error};
use fmt; use fmt;
use thread; use thread;
@ -144,8 +144,8 @@ impl<T> PoisonError<T> {
pub fn get_mut(&mut self) -> &mut T { &mut self.guard } pub fn get_mut(&mut self) -> &mut T { &mut self.guard }
} }
impl<T> FromError<PoisonError<T>> for TryLockError<T> { impl<T> From<PoisonError<T>> for TryLockError<T> {
fn from_error(err: PoisonError<T>) -> TryLockError<T> { fn from(err: PoisonError<T>) -> TryLockError<T> {
TryLockError::Poisoned(err) TryLockError::Poisoned(err)
} }
} }