Struct ArcBiFunction 

pub struct ArcBiFunction<T, U, R> { /* private fields */ }

ArcBiFunction - thread-safe bi-function wrapper

A thread-safe, clonable bi-function wrapper suitable for multi-threaded scenarios. Can be called multiple times and shared across threads.

Features

• Based on: Arc<dyn Fn(&T, &U) -> R + Send + Sync>
• Ownership: Shared ownership via reference counting
• Reusability: Can be called multiple times (borrows inputs each time)
• Thread Safety: Thread-safe (Send + Sync required)
• Clonable: Cheap cloning via Arc::clone

Author

Haixing Hu

Implementations

impl<T, U, R> ArcBiFunction<T, U, R>

where T: 'static, U: 'static, R: 'static,

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

where F: Fn(&T, &U) -> R + Send + Sync + 'static,

Creates a new bi-function.

Wraps the provided closure in the appropriate smart pointer type for this bi-function implementation.

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

where F: Fn(&T, &U) -> R + Send + Sync + 'static,

Creates a new named bi-function.

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

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

where F: Fn(&T, &U) -> R + Send + Sync + 'static,

Creates a new named bi-function with an optional name.

Wraps the provided closure and assigns it an optional name.

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

Gets the name of this bi-function.

Returns

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

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

Sets the name of this bi-function.

Parameters

• name - The name to set for this bi-function

pub fn when<P>(&self, predicate: P) -> ArcConditionalBiFunction<T, U, R>

where P: BiPredicate<T, U> + Send + Sync + 'static,

Creates a conditional two-parameter function that executes based on bi-predicate result.

Parameters

• predicate - The bi-predicate to determine whether to execute the function operation

Returns

Returns a conditional two-parameter function that only executes when the predicate returns true.

Examples

use prism3_function::{ArcBiFunction, BiFunction};
use std::sync::Arc;

let add = ArcBiFunction::new(|x: i32, y: i32| x + y);
let conditional = add.when(|x: &i32, y: &i32| *x > 0 && *y > 0);
assert_eq!(conditional.or_else(|_, _| 0).apply(2, 3), 5);  // executed
assert_eq!(conditional.or_else(|_, _| 0).apply(-1, 3), 0); // not executed

pub fn and_then<S, F>(&self, after: F) -> ArcBiFunction<T, U, S>

where S: 'static, F: Function<R, S> + Send + Sync + 'static,

Chains execution with another two-parameter function, executing the current function first, then the subsequent function.

Parameters

• after - The subsequent two-parameter function to execute after the current function completes

Returns

Returns a new two-parameter function that executes the current function and the subsequent function in sequence.

Examples

use prism3_function::{ArcBiFunction, BiFunction};
use std::sync::Arc;

let add = ArcBiFunction::new(|x: i32, y: i32| x + y);
let multiply_by_two = ArcBiFunction::new(|x: i32, y: i32| x * y * 2);

let chained = add.and_then(multiply_by_two);
assert_eq!(chained.apply(2, 3), 10); // (2+3) * 2 = 10

impl<T, U, R> ArcBiFunction<T, U, R>

where T: 'static, U: 'static, R: Clone + Send + Sync + 'static,

pub fn constant(value: R) -> ArcBiFunction<T, U, R>

Creates a constant function

Examples

/// rust /// use prism3_function::{ArcBiFunction, BiFunction}; /// /// let constant = ArcBiFunction::constant("hello"); /// assert_eq!(constant.apply(123, "test"), "hello"); ///

Trait Implementations

impl<T, U, R> BiFunction<T, U, R> for ArcBiFunction<T, U, R>

fn apply(&self, first: &T, second: &U) -> R

Applies the bi-function to two input references to produce an output value

fn into_box(self) -> BoxBiFunction<T, U, R>

where T: 'static, U: 'static, R: 'static,

Converts to BoxBiFunction

fn into_rc(self) -> RcBiFunction<T, U, R>

where T: 'static, U: 'static, R: 'static,

Converts to RcBiFunction

fn into_arc(self) -> ArcBiFunction<T, U, R>

where T: 'static, U: 'static, R: 'static,

Converts to ArcBiFunction

fn into_fn(self) -> impl Fn(&T, &U) -> R

Converts bi-function to a closure

fn into_once(self) -> BoxBiFunctionOnce<T, U, R>

where T: 'static, U: 'static, R: 'static,

Converts to BiFunctionOnce

fn to_box(&self) -> BoxBiFunction<T, U, R>

where T: 'static, U: 'static, R: 'static,

Non-consuming conversion to BoxBiFunction using &self.

fn to_rc(&self) -> RcBiFunction<T, U, R>

where T: 'static, U: 'static, R: 'static,

Non-consuming conversion to RcBiFunction using &self.

fn to_arc(&self) -> ArcBiFunction<T, U, R>

where T: 'static, U: 'static, R: 'static,

Non-consuming conversion to ArcBiFunction using &self.

fn to_fn(&self) -> impl Fn(&T, &U) -> R

Non-consuming conversion to a boxed function using &self.

fn to_once(&self) -> BoxBiFunctionOnce<T, U, R>

where T: 'static, U: 'static, R: 'static,

Convert to BiFunctionOnce without consuming self

impl<T, U, R> Clone for ArcBiFunction<T, U, R>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T, U, R> Debug for ArcBiFunction<T, U, R>

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

Formats the value using the given formatter.

impl<T, U, R> Display for ArcBiFunction<T, U, R>

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

Formats the value using the given formatter.