Struct LocalBoxCallableOnce 

pub struct LocalBoxCallableOnce<R, E> { /* private fields */ }

Local box-based one-time callable.

LocalBoxCallableOnce<R, E> stores a Box<dyn FnOnce() -> Result<R, E>> and can be executed only once on the local thread. Use BoxCallableOnce when the callable must be movable across threads.

Type Parameters

• R - The success value returned by the computation.
• E - The error value returned when the computation fails.

Implementations

impl<R, E> LocalBoxCallableOnce<R, E>

pub fn new<F>(function: F) -> Self

where F: FnOnce() -> Result<R, E> + 'static,

Creates a new local callable.

Wraps the provided closure in the appropriate smart pointer type for this local callable implementation.

pub fn new_with_name<F>(name: &str, function: F) -> Self

where F: FnOnce() -> Result<R, E> + 'static,

Creates a new named local callable.

Wraps the provided closure and assigns it a name, which is useful for debugging and logging purposes.

pub fn new_with_optional_name<F>(function: F, name: Option<String>) -> Self

where F: FnOnce() -> Result<R, E> + 'static,

Creates a new named local callable with an optional name.

Wraps the provided closure and assigns it an optional name.

pub fn from_supplier<S>(supplier: S) -> Self

where S: SupplierOnce<Result<R, E>> + 'static,

Creates a local boxed callable from a one-time supplier.

This is an explicit bridge from SupplierOnce<Result<R, E>> to CallableOnce<R, E> without requiring Send.

Parameters

• supplier - The supplier that produces the callable result.

Returns

A new LocalBoxCallableOnce<R, E>.

pub fn name(&self) -> Option<&str>

Gets the name of this local callable.

Returns

Returns Some(&str) if a name was set, None otherwise.

pub fn set_name(&mut self, name: &str)

Sets the name of this local callable.

Parameters

• name - The name to set for this local callable

pub fn clear_name(&mut self)

Clears the name of this local callable.

pub fn map<U, M>(self, mapper: M) -> LocalBoxCallableOnce<U, E>

where M: FnOnce(R) -> U + 'static, R: 'static, E: 'static,

Maps the success value of this callable.

Parameters

• mapper - Function that transforms the success value.

Returns

A new local callable that applies mapper when this callable succeeds.

pub fn map_err<E2, M>(self, mapper: M) -> LocalBoxCallableOnce<R, E2>

where M: FnOnce(E) -> E2 + 'static, R: 'static, E: 'static,

Maps the error value of this callable.

Parameters

• mapper - Function that transforms the error value.

Returns

A new local callable that applies mapper when this callable fails.

pub fn and_then<U, N>(self, next: N) -> LocalBoxCallableOnce<U, E>

where N: FnOnce(R) -> Result<U, E> + 'static, R: 'static, E: 'static,

Chains another fallible computation after this callable succeeds.

Parameters

• next - Function that receives the success value and returns the next result.

Returns

A new local callable that runs next only when this callable succeeds.

Trait Implementations

impl<R, E> CallableOnce<R, E> for LocalBoxCallableOnce<R, E>

fn call(self) -> Result<R, E>

Executes the local boxed callable.

fn into_local_box(self) -> LocalBoxCallableOnce<R, E>

where Self: Sized + 'static,

Converts this local boxed callable into itself.

fn into_fn(self) -> impl FnOnce() -> Result<R, E>

where Self: Sized + 'static,

Extracts the underlying local one-time closure.

fn into_local_runnable(self) -> LocalBoxRunnableOnce<E>

where Self: Sized + 'static,

Converts this local boxed callable into a local boxed runnable while preserving its name.

fn into_box(self) -> BoxCallableOnce<R, E>

where Self: Sized + Send + 'static,

Converts this callable into a boxed callable.

fn into_runnable(self) -> BoxRunnableOnce<E>

where Self: Sized + Send + 'static,

Converts this callable into a runnable by discarding the success value.

impl<R, E> Debug for LocalBoxCallableOnce<R, E>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<R, E> Display for LocalBoxCallableOnce<R, E>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<R, E> SupplierOnce<Result<R, E>> for LocalBoxCallableOnce<R, E>

fn get(self) -> Result<R, E>

Executes the local boxed callable as a one-time supplier of Result<R, E>.

fn into_box(self) -> BoxSupplierOnce<T>

where Self: Sized + 'static,

Converts to BoxSupplierOnce.

fn into_fn(self) -> impl FnOnce() -> T

where Self: Sized + 'static,

Converts the supplier to a Box<dyn FnOnce() -> T>.