1.34.0[][src]Enum std::convert::Infallible

pub enum Infallible {}

The error type for errors that can never happen.

Since this enum has no variant, a value of this type can never actually exist. This can be useful for generic APIs that use Result and parameterize the error type, to indicate that the result is always Ok.

For example, the TryFrom trait (conversion that returns a Result) has a blanket implementation for all types where a reverse Into implementation exists.

This example is not tested
impl<T, U> TryFrom<U> for T where U: Into<T> {
    type Error = Infallible;

    fn try_from(value: U) -> Result<Self, Infallible> {
        Ok(U::into(value))  // Never returns `Err`
    }
}Run

Future compatibility

This enum has the same role as the ! “never” type, which is unstable in this version of Rust. When ! is stabilized, we plan to make Infallible a type alias to it:

This example is not tested
pub type Infallible = !;Run

… and eventually deprecate Infallible.

However there is one case where ! syntax can be used before ! is stabilized as a full-fleged type: in the position of a function’s return type. Specifically, it is possible implementations for two different function pointer types:

trait MyTrait {}
impl MyTrait for fn() -> ! {}
impl MyTrait for fn() -> std::convert::Infallible {}Run

With Infallible being an enum, this code is valid. However when Infallible becomes an alias for the never type, the two impls will start to overlap and therefore will be disallowed by the language’s trait coherence rules.

Trait Implementations

impl Eq for Infallible[src]

impl From<!> for Infallible[src]

impl From<Infallible> for TryFromIntError[src]

impl From<Infallible> for TryFromSliceError1.36.0[src]

impl Clone for Infallible[src]

impl Debug for Infallible[src]

impl PartialEq<Infallible> for Infallible[src]

impl PartialOrd<Infallible> for Infallible[src]

impl Display for Infallible[src]

impl Ord for Infallible[src]

impl Copy for Infallible[src]

Auto Trait Implementations

impl UnwindSafe for Infallible

impl RefUnwindSafe for Infallible

impl Unpin for Infallible

impl Send for Infallible

impl Sync for Infallible

Blanket Implementations

impl<T> From<T> for T[src]

impl<T> From<!> for T[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T> ToString for T where
    T: Display + ?Sized
[src]