Trait tap::TapFallible

source · [−]
pub trait TapFallible where
    Self: Sized, {
    type Ok: ?Sized;
    type Err: ?Sized;
    fn tap_ok(self, func: impl FnOnce(&Self::Ok)) -> Self;

    fn tap_ok_mut(self, func: impl FnOnce(&mut Self::Ok)) -> Self;

    fn tap_err(self, func: impl FnOnce(&Self::Err)) -> Self;

    fn tap_err_mut(self, func: impl FnOnce(&mut Self::Err)) -> Self;

    fn tap_ok_dbg(self, func: impl FnOnce(&Self::Ok)) -> Self { ... }

    fn tap_ok_mut_dbg(self, func: impl FnOnce(&mut Self::Ok)) -> Self { ... }

    fn tap_err_dbg(self, func: impl FnOnce(&Self::Err)) -> Self { ... }

    fn tap_err_mut_dbg(self, func: impl FnOnce(&mut Self::Err)) -> Self { ... }
}
Expand description

Fallible tapping, conditional on the optional success of an expression.

This trait is intended for use on types that express the concept of “fallible presence”, primarily the Result monad. It provides taps that inspect the container to determine if the effect function should execute or not.

Note: This trait would ideally be implemented as a blanket over all std::ops::Try implementors. When Try stabilizes, this crate can be updated to do so.

Associated Types

The interior type used to indicate a successful construction.

The interior type used to indicate a failed construction.

Required methods

Immutably accesses an interior success value.

This function is identical to Tap::tap, except that it is required to check the implementing container for value success before running. Implementors must not run the effect function if the container is marked as being a failure.

Mutably accesses an interior success value.

This function is identical to Tap::tap_mut, except that it is required to check the implementing container for value success before running. Implementors must not run the effect function if the container is marked as being a failure.

Immutably accesses an interior failure value.

This function is identical to Tap::tap, except that it is required to check the implementing container for value failure before running. Implementors must not run the effect function if the container is marked as being a success.

Mutably accesses an interior failure value.

This function is identical to Tap::tap_mut, except that it is required to check the implementing container for value failure before running. Implementors must not run the effect function if the container is marked as being a success.

Provided methods

Calls .tap_ok() only in debug builds, and is erased in release builds.

Calls .tap_ok_mut() only in debug builds, and is erased in release builds.

Calls .tap_err() only in debug builds, and is erased in release builds.

Calls .tap_err_mut() only in debug builds, and is erased in release builds.

Implementations on Foreign Types

Implementors