qubit_function::transformers::bi_transformer_once

Trait BiTransformerOnce

pub trait BiTransformerOnce<T, U, R> {
    // Required method
    fn apply(self, first: T, second: U) -> R;

    // Provided methods
    fn into_box(self) -> BoxBiTransformerOnce<T, U, R>
       where Self: Sized + 'static { ... }
    fn into_fn(self) -> impl FnOnce(T, U) -> R
       where Self: Sized + 'static { ... }
    fn to_box(&self) -> BoxBiTransformerOnce<T, U, R>
       where Self: Clone + 'static { ... }
    fn to_fn(&self) -> impl FnOnce(T, U) -> R
       where Self: Clone + 'static { ... }
}

Expand description

BiTransformerOnce trait - consuming bi-transformation that takes ownership

Defines the behavior of a consuming bi-transformer: converting two values of types T and U to a value of type R by taking ownership of self and both inputs. This trait is analogous to FnOnce(T, U) -> R.

§Type Parameters

T - The type of the first input value (consumed)
U - The type of the second input value (consumed)
R - The type of the output value

§Author

Haixing Hu

Required Methods§

Source

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

Transforms two input values, consuming self and both inputs

§Parameters

first - The first input value (consumed)
second - The second input value (consumed)

§Returns

The transformed output value

Provided Methods§

Source

fn into_box(self) -> BoxBiTransformerOnce<T, U, R>
where Self: Sized + 'static,

Converts to BoxBiTransformerOnce

⚠️ Consumes self: The original bi-transformer becomes unavailable after calling this method.

§Returns

Returns BoxBiTransformerOnce<T, U, R>

Examples found in repository ?

examples/transformers/bi_transformer_once_demo.rs (line 111)

16fn main() {
17    println!("=== BiTransformerOnce Examples ===\n");
18
19    // Example 1: Basic usage with closure
20    println!("1. Basic usage with closure:");
21    let add = |x: i32, y: i32| x + y;
22    let result = add.apply(20, 22);
23    println!("   20 + 22 = {}", result);
24
25    // Example 2: BoxBiTransformerOnce with new
26    println!("\n2. BoxBiTransformerOnce with new:");
27    let multiply = BoxBiTransformerOnce::new(|x: i32, y: i32| x * y);
28    println!("   6 * 7 = {}", multiply.apply(6, 7));
29
30    // Example 3: Constant transformer
31    println!("\n3. Constant transformer:");
32    let constant = BoxBiTransformerOnce::constant("hello");
33    println!("   constant(123, 456) = {}", constant.apply(123, 456));
34
35    // Example 4: Consuming owned values
36    println!("\n4. Consuming owned values:");
37    let concat = BoxBiTransformerOnce::new(|x: String, y: String| format!("{} {}", x, y));
38    let s1 = String::from("hello");
39    let s2 = String::from("world");
40    let result = concat.apply(s1, s2);
41    println!("   concat('hello', 'world') = {}", result);
42
43    // Example 5: Conditional transformation with when/or_else
44    println!("\n5. Conditional transformation (positive numbers):");
45    let add = BoxBiTransformerOnce::new(|x: i32, y: i32| x + y);
46    let multiply = BoxBiTransformerOnce::new(|x: i32, y: i32| x * y);
47    let conditional = add
48        .when(|x: &i32, y: &i32| *x > 0 && *y > 0)
49        .or_else(multiply);
50    println!("   conditional(5, 3) = {} (add)", conditional.apply(5, 3));
51
52    println!("\n6. Conditional transformation (negative numbers):");
53    let add2 = BoxBiTransformerOnce::new(|x: i32, y: i32| x + y);
54    let multiply2 = BoxBiTransformerOnce::new(|x: i32, y: i32| x * y);
55    let conditional2 = add2
56        .when(|x: &i32, y: &i32| *x > 0 && *y > 0)
57        .or_else(multiply2);
58    println!(
59        "   conditional(-5, 3) = {} (multiply)",
60        conditional2.apply(-5, 3)
61    );
62
63    // Example 7: Conditional with closure in or_else
64    println!("\n7. Conditional with closure in or_else:");
65    let add3 = BoxBiTransformerOnce::new(|x: i32, y: i32| x + y);
66    let conditional3 = add3
67        .when(|x: &i32, y: &i32| *x > 0 && *y > 0)
68        .or_else(|x: i32, y: i32| x * y);
69    println!("   conditional(4, 6) = {}", conditional3.apply(4, 6));
70
71    // Example 8: Merging vectors
72    println!("\n8. Merging vectors:");
73    let merge = BoxBiTransformerOnce::new(|mut x: Vec<i32>, y: Vec<i32>| {
74        x.extend(y);
75        x
76    });
77    let v1 = vec![1, 2, 3];
78    let v2 = vec![4, 5, 6];
79    let result = merge.apply(v1, v2);
80    println!("   merge([1, 2, 3], [4, 5, 6]) = {:?}", result);
81
82    // Example 9: Complex transformation with calculation
83    println!("\n9. Complex transformation with calculation:");
84    let calculate = BoxBiTransformerOnce::new(|x: i32, y: i32| {
85        let sum = x + y;
86        let product = x * y;
87        (sum, product)
88    });
89    let (sum, product) = calculate.apply(5, 3);
90    println!("   calculate(5, 3) = (sum: {}, product: {})", sum, product);
91
92    // Example 10: String manipulation
93    println!("\n10. String manipulation:");
94    let process = BoxBiTransformerOnce::new(|x: String, y: String| {
95        format!("{} {} {}", x.to_uppercase(), "and", y.to_lowercase())
96    });
97    println!(
98        "   process('Hello', 'WORLD') = {}",
99        process.apply("Hello".to_string(), "WORLD".to_string())
100    );
101
102    // Example 11: Converting to function
103    println!("\n11. Converting to function:");
104    let add4 = BoxBiTransformerOnce::new(|x: i32, y: i32| x + y);
105    let f = add4.into_fn();
106    println!("   f(10, 20) = {}", f(10, 20));
107
108    // Example 12: Converting to box (zero-cost)
109    println!("\n12. Converting to box (zero-cost):");
110    let add5 = BoxBiTransformerOnce::new(|x: i32, y: i32| x + y);
111    let boxed = add5.into_box();
112    println!("   boxed(15, 25) = {}", boxed.apply(15, 25));
113
114    println!("\n=== All examples completed successfully! ===");
115}

Source

fn into_fn(self) -> impl FnOnce(T, U) -> R
where Self: Sized + 'static,

Converts bi-transformer to a closure

⚠️ Consumes self: The original bi-transformer becomes unavailable after calling this method.

§Returns

Returns a closure that implements FnOnce(T, U) -> R

Examples found in repository ?

examples/transformers/bi_transformer_once_demo.rs (line 105)

16fn main() {
17    println!("=== BiTransformerOnce Examples ===\n");
18
19    // Example 1: Basic usage with closure
20    println!("1. Basic usage with closure:");
21    let add = |x: i32, y: i32| x + y;
22    let result = add.apply(20, 22);
23    println!("   20 + 22 = {}", result);
24
25    // Example 2: BoxBiTransformerOnce with new
26    println!("\n2. BoxBiTransformerOnce with new:");
27    let multiply = BoxBiTransformerOnce::new(|x: i32, y: i32| x * y);
28    println!("   6 * 7 = {}", multiply.apply(6, 7));
29
30    // Example 3: Constant transformer
31    println!("\n3. Constant transformer:");
32    let constant = BoxBiTransformerOnce::constant("hello");
33    println!("   constant(123, 456) = {}", constant.apply(123, 456));
34
35    // Example 4: Consuming owned values
36    println!("\n4. Consuming owned values:");
37    let concat = BoxBiTransformerOnce::new(|x: String, y: String| format!("{} {}", x, y));
38    let s1 = String::from("hello");
39    let s2 = String::from("world");
40    let result = concat.apply(s1, s2);
41    println!("   concat('hello', 'world') = {}", result);
42
43    // Example 5: Conditional transformation with when/or_else
44    println!("\n5. Conditional transformation (positive numbers):");
45    let add = BoxBiTransformerOnce::new(|x: i32, y: i32| x + y);
46    let multiply = BoxBiTransformerOnce::new(|x: i32, y: i32| x * y);
47    let conditional = add
48        .when(|x: &i32, y: &i32| *x > 0 && *y > 0)
49        .or_else(multiply);
50    println!("   conditional(5, 3) = {} (add)", conditional.apply(5, 3));
51
52    println!("\n6. Conditional transformation (negative numbers):");
53    let add2 = BoxBiTransformerOnce::new(|x: i32, y: i32| x + y);
54    let multiply2 = BoxBiTransformerOnce::new(|x: i32, y: i32| x * y);
55    let conditional2 = add2
56        .when(|x: &i32, y: &i32| *x > 0 && *y > 0)
57        .or_else(multiply2);
58    println!(
59        "   conditional(-5, 3) = {} (multiply)",
60        conditional2.apply(-5, 3)
61    );
62
63    // Example 7: Conditional with closure in or_else
64    println!("\n7. Conditional with closure in or_else:");
65    let add3 = BoxBiTransformerOnce::new(|x: i32, y: i32| x + y);
66    let conditional3 = add3
67        .when(|x: &i32, y: &i32| *x > 0 && *y > 0)
68        .or_else(|x: i32, y: i32| x * y);
69    println!("   conditional(4, 6) = {}", conditional3.apply(4, 6));
70
71    // Example 8: Merging vectors
72    println!("\n8. Merging vectors:");
73    let merge = BoxBiTransformerOnce::new(|mut x: Vec<i32>, y: Vec<i32>| {
74        x.extend(y);
75        x
76    });
77    let v1 = vec![1, 2, 3];
78    let v2 = vec![4, 5, 6];
79    let result = merge.apply(v1, v2);
80    println!("   merge([1, 2, 3], [4, 5, 6]) = {:?}", result);
81
82    // Example 9: Complex transformation with calculation
83    println!("\n9. Complex transformation with calculation:");
84    let calculate = BoxBiTransformerOnce::new(|x: i32, y: i32| {
85        let sum = x + y;
86        let product = x * y;
87        (sum, product)
88    });
89    let (sum, product) = calculate.apply(5, 3);
90    println!("   calculate(5, 3) = (sum: {}, product: {})", sum, product);
91
92    // Example 10: String manipulation
93    println!("\n10. String manipulation:");
94    let process = BoxBiTransformerOnce::new(|x: String, y: String| {
95        format!("{} {} {}", x.to_uppercase(), "and", y.to_lowercase())
96    });
97    println!(
98        "   process('Hello', 'WORLD') = {}",
99        process.apply("Hello".to_string(), "WORLD".to_string())
100    );
101
102    // Example 11: Converting to function
103    println!("\n11. Converting to function:");
104    let add4 = BoxBiTransformerOnce::new(|x: i32, y: i32| x + y);
105    let f = add4.into_fn();
106    println!("   f(10, 20) = {}", f(10, 20));
107
108    // Example 12: Converting to box (zero-cost)
109    println!("\n12. Converting to box (zero-cost):");
110    let add5 = BoxBiTransformerOnce::new(|x: i32, y: i32| x + y);
111    let boxed = add5.into_box();
112    println!("   boxed(15, 25) = {}", boxed.apply(15, 25));
113
114    println!("\n=== All examples completed successfully! ===");
115}

Source

fn to_box(&self) -> BoxBiTransformerOnce<T, U, R>
where Self: Clone + 'static,

Converts bi-transformer to a boxed function pointer

📌 Borrows &self: The original bi-transformer remains usable after calling this method.

§Returns

Returns a boxed function pointer that implements FnOnce(T, U) -> R

§Examples

use qubit_function::BiTransformerOnce;

let add = |x: i32, y: i32| x + y;
let func = add.to_fn();
assert_eq!(func(20, 22), 42);

Source

fn to_fn(&self) -> impl FnOnce(T, U) -> R
where Self: Clone + 'static,

Converts bi-transformer to a closure

📌 Borrows &self: The original bi-transformer remains usable after calling this method.

§Returns

Returns a closure that implements FnOnce(T, U) -> R

§Examples

use qubit_function::BiTransformerOnce;

let add = |x: i32, y: i32| x + y;
let func = add.to_fn();
assert_eq!(func(20, 22), 42);

BiTransformerOnce

Trait BiTransformerOnce

§Type Parameters

§Author

Required Methods§

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

§Parameters

§Returns

Provided Methods§

fn into_box(self) -> BoxBiTransformerOnce<T, U, R>
where Self: Sized + 'static,

§Returns

Examples found in repository ?

fn into_fn(self) -> impl FnOnce(T, U) -> R
where Self: Sized + 'static,

§Returns

Examples found in repository ?

fn to_box(&self) -> BoxBiTransformerOnce<T, U, R>
where Self: Clone + 'static,

§Returns

§Examples

fn to_fn(&self) -> impl FnOnce(T, U) -> R
where Self: Clone + 'static,

§Returns

§Examples

Implementors§

impl<F, T, U, R> BiTransformerOnce<T, U, R> for F
where F: FnOnce(T, U) -> R,

impl<T, U, R> BiTransformerOnce<T, U, R> for BoxBiTransformerOnce<T, U, R>

Trait BiTransformerOnce Copy item path

§Type Parameters

§Author

Required Methods§

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

§Parameters

§Returns

Provided Methods§

fn into_box(self) -> BoxBiTransformerOnce<T, U, R>where Self: Sized + 'static,

§Returns

fn into_fn(self) -> impl FnOnce(T, U) -> Rwhere Self: Sized + 'static,

§Returns

fn to_box(&self) -> BoxBiTransformerOnce<T, U, R>where Self: Clone + 'static,

§Returns

§Examples

fn to_fn(&self) -> impl FnOnce(T, U) -> Rwhere Self: Clone + 'static,

§Returns

§Examples

Implementors§

impl<F, T, U, R> BiTransformerOnce<T, U, R> for Fwhere F: FnOnce(T, U) -> R,

impl<T, U, R> BiTransformerOnce<T, U, R> for BoxBiTransformerOnce<T, U, R>

Trait BiTransformerOnce

fn into_box(self) -> BoxBiTransformerOnce<T, U, R>
where Self: Sized + 'static,

fn into_fn(self) -> impl FnOnce(T, U) -> R
where Self: Sized + 'static,

fn to_box(&self) -> BoxBiTransformerOnce<T, U, R>
where Self: Clone + 'static,

fn to_fn(&self) -> impl FnOnce(T, U) -> R
where Self: Clone + 'static,

impl<F, T, U, R> BiTransformerOnce<T, U, R> for F
where F: FnOnce(T, U) -> R,