Struct BufResult

pub struct BufResult<T, B>(pub Result<T, Error>, pub B);

A specialized Result type for operations with buffers.

This type is used as a return value for asynchronous compio methods that require passing ownership of a buffer to the runtime. When the operation completes, the buffer is returned no matter if the operation completed successfully.

Tuple Fields

0: Result<T, Error>

1: B

Implementations

impl<T, B> BufResult<T, B>

pub const fn is_ok(&self) -> bool

Returns true if the result is Ok.

pub const fn is_err(&self) -> bool

Returns true if the result is Err.

pub fn map<U>(self, f: impl FnOnce(T, B) -> (U, B)) -> BufResult<U, B>

Maps the result part, and allows updating the buffer.

pub fn map2<U, C>( self, f_ok: impl FnOnce(T, B) -> (U, C), f_err: impl FnOnce(B) -> C, ) -> BufResult<U, C>

Maps the result part, and allows changing the buffer type.

pub fn map_res<U>(self, f: impl FnOnce(T) -> U) -> BufResult<U, B>

Maps the result part, and keeps the buffer unchanged.

pub fn map_buffer<C>(self, f: impl FnOnce(B) -> C) -> BufResult<T, C>

Maps the buffer part, and keeps the result unchanged.

pub fn and_then<U>( self, f: impl FnOnce(T, B) -> (Result<U, Error>, B), ) -> BufResult<U, B>

Updating the result type and modifying the buffer.

pub fn expect(self, msg: &str) -> (T, B)

Returns the contained Ok value, consuming the self value.

pub fn unwrap(self) -> (T, B)

Returns the contained Ok value, consuming the self value.

Trait Implementations

impl<T, O> BufResultExt for BufResult<(usize, O), T>

where T: SetBufInit,

fn map_advanced(self) -> BufResult<(usize, O), T>

Call SetBufInit::set_buf_init if the result is Ok.

impl<T, C, O> BufResultExt for BufResult<(usize, usize, O), (T, C)>

where T: SetBufInit, C: SetBufInit,

fn map_advanced(self) -> BufResult<(usize, usize, O), (T, C)>

Call SetBufInit::set_buf_init if the result is Ok.

impl<T> BufResultExt for BufResult<usize, T>

where T: SetBufInit,

fn map_advanced(self) -> BufResult<usize, T>

Call SetBufInit::set_buf_init if the result is Ok.

impl<T, B> From<(Result<T, Error>, B)> for BufResult<T, B>

fn from(_: (Result<T, Error>, B)) -> BufResult<T, B>

Converts to this type from the input type.

impl<T, B> FromResidual<BufResult<Infallible, B>> for BufResult<T, B>

Available on crate feature try_trait_v2 only.

fn foo() -> BufResult<i32, i32> {
    let (a, b) = BufResult(Ok(1), 2)?;
    assert_eq!(a, 1);
    assert_eq!(b, 2);
    (Ok(3), 4).into()
}
assert!(foo().is_ok());

fn from_residual(residual: BufResult<Infallible, B>) -> BufResult<T, B>

🔬This is a nightly-only experimental API. (try_trait_v2)

Constructs the type from a compatible Residual type.

impl<T, B> FromResidual<BufResult<Infallible, B>> for Result<T, Error>

Available on crate feature try_trait_v2 only.

fn foo() -> std::io::Result<i32> {
    let (a, b) = BufResult(Ok(1), 2)?;
    assert_eq!(a, 1);
    assert_eq!(b, 2);
    Ok(3)
}
assert!(foo().is_ok());

fn from_residual(residual: BufResult<Infallible, B>) -> Result<T, Error>

🔬This is a nightly-only experimental API. (try_trait_v2)

Constructs the type from a compatible Residual type.

impl<T, O> IntoInner for BufResult<O, T>

where T: IntoInner,

type Inner = BufResult<O, <T as IntoInner>::Inner>

The inner type.

fn into_inner(self) -> <BufResult<O, T> as IntoInner>::Inner

Get the inner buffer.

impl<T> RecvResultExt for BufResult<usize, (T, sockaddr_storage, u32)>

type RecvResult = BufResult<(usize, SockAddr), T>

The mapped result.

fn map_addr( self, ) -> <BufResult<usize, (T, sockaddr_storage, u32)> as RecvResultExt>::RecvResult

Create SockAddr if the result is Ok.

impl<T> RecvResultExt for BufResult<usize, (T, sockaddr_storage, u32, usize)>

type RecvResult = BufResult<(usize, usize, SockAddr), T>

The mapped result.

fn map_addr( self, ) -> <BufResult<usize, (T, sockaddr_storage, u32, usize)> as RecvResultExt>::RecvResult

Create SockAddr if the result is Ok.

impl<T, B> Residual<(T, B)> for BufResult<Infallible, B>

Available on crate feature try_trait_v2 only.

type TryType = BufResult<T, B>

🔬This is a nightly-only experimental API. (try_trait_v2_residual)

The “return” type of this meta-function.

impl<T, B> Try for BufResult<T, B>

Available on crate feature try_trait_v2 only.

type Output = (T, B)

🔬This is a nightly-only experimental API. (try_trait_v2)

The type of the value produced by ? when not short-circuiting.

type Residual = BufResult<Infallible, B>

🔬This is a nightly-only experimental API. (try_trait_v2)

The type of the value passed to FromResidual::from_residual as part of ? when short-circuiting.

fn from_output(_: <BufResult<T, B> as Try>::Output) -> BufResult<T, B>

🔬This is a nightly-only experimental API. (try_trait_v2)

Constructs the type from its Output type.

fn branch( self, ) -> ControlFlow<<BufResult<T, B> as Try>::Residual, <BufResult<T, B> as Try>::Output>

🔬This is a nightly-only experimental API. (try_trait_v2)

Used in ? to decide whether the operator should produce a value (because this returned ControlFlow::Continue) or propagate a value back to the caller (because this returned ControlFlow::Break).