Skip to main content

ArcBiPredicate

Struct ArcBiPredicate 

Source
pub struct ArcBiPredicate<T, U> { /* private fields */ }
Expand description

An Arc-based bi-predicate with thread-safe shared ownership.

This type is suitable for scenarios where the bi-predicate needs to be shared across threads. Composition methods borrow &self, allowing the original bi-predicate to remain usable after composition.

§Examples

use qubit_function::{BiPredicate, ArcBiPredicate};

let pred = ArcBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
assert!(pred.test(&5, &3));

// Original bi-predicate remains usable after composition
let combined = pred.and(ArcBiPredicate::new(|x, y| x > y));
assert!(pred.test(&5, &3));  // Still works

// Can be cloned and sent across threads
let pred_clone = pred.clone();
std::thread::spawn(move || {
    assert!(pred_clone.test(&10, &5));
}).join().unwrap();

Implementations§

Source§

impl<T, U> ArcBiPredicate<T, U>

Source

pub fn new<F>(f: F) -> Self
where F: Fn(&T, &U) -> bool + Send + Sync + 'static,

Creates a new bi-predicate.

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

Source

pub fn new_with_name<F>(name: &str, f: F) -> Self
where F: Fn(&T, &U) -> bool + Send + Sync + 'static,

Creates a new named bi-predicate.

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

Source

pub fn new_with_optional_name<F>(f: F, name: Option<String>) -> Self
where F: Fn(&T, &U) -> bool + Send + Sync + 'static,

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

Wraps the provided closure and assigns it an optional name.

Source

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

Gets the name of this bi-predicate.

§Returns

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

Examples found in repository?
examples/predicates/always_bi_predicate_demo.rs (line 83)
17fn main() {
18    println!("=== BoxBiPredicate always_true/always_false Demo ===\n");
19
20    // BoxBiPredicate::always_true
21    let always_true: BoxBiPredicate<i32, i32> = BoxBiPredicate::always_true();
22    println!("BoxBiPredicate::always_true():");
23    println!("  test(&42, &10): {}", always_true.test(&42, &10));
24    println!("  test(&-1, &5): {}", always_true.test(&-1, &5));
25    println!("  test(&0, &0): {}", always_true.test(&0, &0));
26    println!("  name: {:?}", always_true.name());
27
28    // BoxBiPredicate::always_false
29    let always_false: BoxBiPredicate<i32, i32> = BoxBiPredicate::always_false();
30    println!("\nBoxBiPredicate::always_false():");
31    println!("  test(&42, &10): {}", always_false.test(&42, &10));
32    println!("  test(&-1, &5): {}", always_false.test(&-1, &5));
33    println!("  test(&0, &0): {}", always_false.test(&0, &0));
34    println!("  name: {:?}", always_false.name());
35
36    println!("\n=== RcBiPredicate always_true/always_false Demo ===\n");
37
38    // RcBiPredicate::always_true
39    let rc_always_true: RcBiPredicate<String, i32> = RcBiPredicate::always_true();
40    println!("RcBiPredicate::always_true():");
41    println!(
42        "  test(&\"hello\", &5): {}",
43        rc_always_true.test(&"hello".to_string(), &5)
44    );
45    println!(
46        "  test(&\"world\", &-3): {}",
47        rc_always_true.test(&"world".to_string(), &-3)
48    );
49    println!("  name: {:?}", rc_always_true.name());
50
51    // RcBiPredicate::always_false
52    let rc_always_false: RcBiPredicate<String, i32> = RcBiPredicate::always_false();
53    println!("\nRcBiPredicate::always_false():");
54    println!(
55        "  test(&\"hello\", &5): {}",
56        rc_always_false.test(&"hello".to_string(), &5)
57    );
58    println!(
59        "  test(&\"world\", &-3): {}",
60        rc_always_false.test(&"world".to_string(), &-3)
61    );
62    println!("  name: {:?}", rc_always_false.name());
63
64    // Can be cloned and reused
65    let rc_clone = rc_always_true.clone();
66    println!("\nAfter cloning, still usable:");
67    println!(
68        "  Original: test(&\"test\", &1): {}",
69        rc_always_true.test(&"test".to_string(), &1)
70    );
71    println!(
72        "  Clone: test(&\"test\", &2): {}",
73        rc_clone.test(&"test".to_string(), &2)
74    );
75
76    println!("\n=== ArcBiPredicate always_true/always_false Demo ===\n");
77
78    // ArcBiPredicate::always_true
79    let arc_always_true: ArcBiPredicate<i32, i32> = ArcBiPredicate::always_true();
80    println!("ArcBiPredicate::always_true():");
81    println!("  test(&100, &50): {}", arc_always_true.test(&100, &50));
82    println!("  test(&-100, &25): {}", arc_always_true.test(&-100, &25));
83    println!("  name: {:?}", arc_always_true.name());
84
85    // ArcBiPredicate::always_false
86    let arc_always_false: ArcBiPredicate<i32, i32> = ArcBiPredicate::always_false();
87    println!("\nArcBiPredicate::always_false():");
88    println!("  test(&100, &50): {}", arc_always_false.test(&100, &50));
89    println!("  test(&-100, &25): {}", arc_always_false.test(&-100, &25));
90    println!("  name: {:?}", arc_always_false.name());
91
92    println!("\n=== Combining with other bi-predicates ===\n");
93
94    // Combining with always_true (AND)
95    let sum_positive = BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
96    let combined_and_true = sum_positive.and(BoxBiPredicate::always_true());
97    println!("sum_positive AND always_true:");
98    println!(
99        "  test(&5, &3): {} (equivalent to sum_positive)",
100        combined_and_true.test(&5, &3)
101    );
102    println!(
103        "  test(&-3, &-5): {} (equivalent to sum_positive)",
104        combined_and_true.test(&-3, &-5)
105    );
106
107    // Combining with always_false (AND)
108    let sum_positive = BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
109    let combined_and_false = sum_positive.and(BoxBiPredicate::always_false());
110    println!("\nsum_positive AND always_false:");
111    println!(
112        "  test(&5, &3): {} (always false)",
113        combined_and_false.test(&5, &3)
114    );
115    println!(
116        "  test(&-3, &-5): {} (always false)",
117        combined_and_false.test(&-3, &-5)
118    );
119
120    // Combining with always_true (OR)
121    let sum_positive = BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
122    let combined_or_true = sum_positive.or(BoxBiPredicate::always_true());
123    println!("\nsum_positive OR always_true:");
124    println!(
125        "  test(&5, &3): {} (always true)",
126        combined_or_true.test(&5, &3)
127    );
128    println!(
129        "  test(&-3, &-5): {} (always true)",
130        combined_or_true.test(&-3, &-5)
131    );
132
133    // Combining with always_false (OR)
134    let sum_positive = BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
135    let combined_or_false = sum_positive.or(BoxBiPredicate::always_false());
136    println!("\nsum_positive OR always_false:");
137    println!(
138        "  test(&5, &3): {} (equivalent to sum_positive)",
139        combined_or_false.test(&5, &3)
140    );
141    println!(
142        "  test(&-3, &-5): {} (equivalent to sum_positive)",
143        combined_or_false.test(&-3, &-5)
144    );
145
146    println!("\n=== Practical scenarios: Default pass/reject filters ===\n");
147
148    // Scenario 1: Default pass-all filter
149    let pairs = vec![(1, 2), (3, 4), (5, 6)];
150    let pass_all = BoxBiPredicate::<i32, i32>::always_true();
151    let closure = pass_all.into_fn();
152    let filtered: Vec<_> = pairs.iter().filter(|(x, y)| closure(x, y)).collect();
153    println!("Default pass all elements: {:?} -> {:?}", pairs, filtered);
154
155    // Scenario 2: Default reject-all filter
156    let pairs = vec![(1, 2), (3, 4), (5, 6)];
157    let reject_all = BoxBiPredicate::<i32, i32>::always_false();
158    let closure = reject_all.into_fn();
159    let filtered: Vec<_> = pairs.iter().filter(|(x, y)| closure(x, y)).collect();
160    println!("Default reject all elements: {:?} -> {:?}", pairs, filtered);
161
162    // Scenario 3: Configurable filter
163    fn configurable_filter(enable_filter: bool) -> BoxBiPredicate<i32, i32> {
164        if enable_filter {
165            BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 5)
166        } else {
167            BoxBiPredicate::always_true()
168        }
169    }
170
171    let pairs = vec![(1, 2), (3, 4), (5, 6)];
172
173    let filter_enabled = configurable_filter(true);
174    let closure = filter_enabled.into_fn();
175    let filtered: Vec<_> = pairs.iter().filter(|(x, y)| closure(x, y)).collect();
176    println!("\nFilter enabled: {:?} -> {:?}", pairs, filtered);
177
178    let filter_disabled = configurable_filter(false);
179    let closure = filter_disabled.into_fn();
180    let filtered: Vec<_> = pairs.iter().filter(|(x, y)| closure(x, y)).collect();
181    println!("Filter disabled: {:?} -> {:?}", pairs, filtered);
182}
Source

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

Sets the name of this bi-predicate.

§Parameters
  • name - The name to set for this bi-predicate
Source

pub fn clear_name(&mut self)

Clears the name of this bi-predicate.

Source

pub fn always_true() -> Self

Creates a bi-predicate that always returns true.

§Returns

A new ArcBiPredicate that always returns true.

Examples found in repository?
examples/predicates/always_bi_predicate_demo.rs (line 79)
17fn main() {
18    println!("=== BoxBiPredicate always_true/always_false Demo ===\n");
19
20    // BoxBiPredicate::always_true
21    let always_true: BoxBiPredicate<i32, i32> = BoxBiPredicate::always_true();
22    println!("BoxBiPredicate::always_true():");
23    println!("  test(&42, &10): {}", always_true.test(&42, &10));
24    println!("  test(&-1, &5): {}", always_true.test(&-1, &5));
25    println!("  test(&0, &0): {}", always_true.test(&0, &0));
26    println!("  name: {:?}", always_true.name());
27
28    // BoxBiPredicate::always_false
29    let always_false: BoxBiPredicate<i32, i32> = BoxBiPredicate::always_false();
30    println!("\nBoxBiPredicate::always_false():");
31    println!("  test(&42, &10): {}", always_false.test(&42, &10));
32    println!("  test(&-1, &5): {}", always_false.test(&-1, &5));
33    println!("  test(&0, &0): {}", always_false.test(&0, &0));
34    println!("  name: {:?}", always_false.name());
35
36    println!("\n=== RcBiPredicate always_true/always_false Demo ===\n");
37
38    // RcBiPredicate::always_true
39    let rc_always_true: RcBiPredicate<String, i32> = RcBiPredicate::always_true();
40    println!("RcBiPredicate::always_true():");
41    println!(
42        "  test(&\"hello\", &5): {}",
43        rc_always_true.test(&"hello".to_string(), &5)
44    );
45    println!(
46        "  test(&\"world\", &-3): {}",
47        rc_always_true.test(&"world".to_string(), &-3)
48    );
49    println!("  name: {:?}", rc_always_true.name());
50
51    // RcBiPredicate::always_false
52    let rc_always_false: RcBiPredicate<String, i32> = RcBiPredicate::always_false();
53    println!("\nRcBiPredicate::always_false():");
54    println!(
55        "  test(&\"hello\", &5): {}",
56        rc_always_false.test(&"hello".to_string(), &5)
57    );
58    println!(
59        "  test(&\"world\", &-3): {}",
60        rc_always_false.test(&"world".to_string(), &-3)
61    );
62    println!("  name: {:?}", rc_always_false.name());
63
64    // Can be cloned and reused
65    let rc_clone = rc_always_true.clone();
66    println!("\nAfter cloning, still usable:");
67    println!(
68        "  Original: test(&\"test\", &1): {}",
69        rc_always_true.test(&"test".to_string(), &1)
70    );
71    println!(
72        "  Clone: test(&\"test\", &2): {}",
73        rc_clone.test(&"test".to_string(), &2)
74    );
75
76    println!("\n=== ArcBiPredicate always_true/always_false Demo ===\n");
77
78    // ArcBiPredicate::always_true
79    let arc_always_true: ArcBiPredicate<i32, i32> = ArcBiPredicate::always_true();
80    println!("ArcBiPredicate::always_true():");
81    println!("  test(&100, &50): {}", arc_always_true.test(&100, &50));
82    println!("  test(&-100, &25): {}", arc_always_true.test(&-100, &25));
83    println!("  name: {:?}", arc_always_true.name());
84
85    // ArcBiPredicate::always_false
86    let arc_always_false: ArcBiPredicate<i32, i32> = ArcBiPredicate::always_false();
87    println!("\nArcBiPredicate::always_false():");
88    println!("  test(&100, &50): {}", arc_always_false.test(&100, &50));
89    println!("  test(&-100, &25): {}", arc_always_false.test(&-100, &25));
90    println!("  name: {:?}", arc_always_false.name());
91
92    println!("\n=== Combining with other bi-predicates ===\n");
93
94    // Combining with always_true (AND)
95    let sum_positive = BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
96    let combined_and_true = sum_positive.and(BoxBiPredicate::always_true());
97    println!("sum_positive AND always_true:");
98    println!(
99        "  test(&5, &3): {} (equivalent to sum_positive)",
100        combined_and_true.test(&5, &3)
101    );
102    println!(
103        "  test(&-3, &-5): {} (equivalent to sum_positive)",
104        combined_and_true.test(&-3, &-5)
105    );
106
107    // Combining with always_false (AND)
108    let sum_positive = BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
109    let combined_and_false = sum_positive.and(BoxBiPredicate::always_false());
110    println!("\nsum_positive AND always_false:");
111    println!(
112        "  test(&5, &3): {} (always false)",
113        combined_and_false.test(&5, &3)
114    );
115    println!(
116        "  test(&-3, &-5): {} (always false)",
117        combined_and_false.test(&-3, &-5)
118    );
119
120    // Combining with always_true (OR)
121    let sum_positive = BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
122    let combined_or_true = sum_positive.or(BoxBiPredicate::always_true());
123    println!("\nsum_positive OR always_true:");
124    println!(
125        "  test(&5, &3): {} (always true)",
126        combined_or_true.test(&5, &3)
127    );
128    println!(
129        "  test(&-3, &-5): {} (always true)",
130        combined_or_true.test(&-3, &-5)
131    );
132
133    // Combining with always_false (OR)
134    let sum_positive = BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
135    let combined_or_false = sum_positive.or(BoxBiPredicate::always_false());
136    println!("\nsum_positive OR always_false:");
137    println!(
138        "  test(&5, &3): {} (equivalent to sum_positive)",
139        combined_or_false.test(&5, &3)
140    );
141    println!(
142        "  test(&-3, &-5): {} (equivalent to sum_positive)",
143        combined_or_false.test(&-3, &-5)
144    );
145
146    println!("\n=== Practical scenarios: Default pass/reject filters ===\n");
147
148    // Scenario 1: Default pass-all filter
149    let pairs = vec![(1, 2), (3, 4), (5, 6)];
150    let pass_all = BoxBiPredicate::<i32, i32>::always_true();
151    let closure = pass_all.into_fn();
152    let filtered: Vec<_> = pairs.iter().filter(|(x, y)| closure(x, y)).collect();
153    println!("Default pass all elements: {:?} -> {:?}", pairs, filtered);
154
155    // Scenario 2: Default reject-all filter
156    let pairs = vec![(1, 2), (3, 4), (5, 6)];
157    let reject_all = BoxBiPredicate::<i32, i32>::always_false();
158    let closure = reject_all.into_fn();
159    let filtered: Vec<_> = pairs.iter().filter(|(x, y)| closure(x, y)).collect();
160    println!("Default reject all elements: {:?} -> {:?}", pairs, filtered);
161
162    // Scenario 3: Configurable filter
163    fn configurable_filter(enable_filter: bool) -> BoxBiPredicate<i32, i32> {
164        if enable_filter {
165            BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 5)
166        } else {
167            BoxBiPredicate::always_true()
168        }
169    }
170
171    let pairs = vec![(1, 2), (3, 4), (5, 6)];
172
173    let filter_enabled = configurable_filter(true);
174    let closure = filter_enabled.into_fn();
175    let filtered: Vec<_> = pairs.iter().filter(|(x, y)| closure(x, y)).collect();
176    println!("\nFilter enabled: {:?} -> {:?}", pairs, filtered);
177
178    let filter_disabled = configurable_filter(false);
179    let closure = filter_disabled.into_fn();
180    let filtered: Vec<_> = pairs.iter().filter(|(x, y)| closure(x, y)).collect();
181    println!("Filter disabled: {:?} -> {:?}", pairs, filtered);
182}
Source

pub fn always_false() -> Self

Creates a bi-predicate that always returns false.

§Returns

A new ArcBiPredicate that always returns false.

Examples found in repository?
examples/predicates/always_bi_predicate_demo.rs (line 86)
17fn main() {
18    println!("=== BoxBiPredicate always_true/always_false Demo ===\n");
19
20    // BoxBiPredicate::always_true
21    let always_true: BoxBiPredicate<i32, i32> = BoxBiPredicate::always_true();
22    println!("BoxBiPredicate::always_true():");
23    println!("  test(&42, &10): {}", always_true.test(&42, &10));
24    println!("  test(&-1, &5): {}", always_true.test(&-1, &5));
25    println!("  test(&0, &0): {}", always_true.test(&0, &0));
26    println!("  name: {:?}", always_true.name());
27
28    // BoxBiPredicate::always_false
29    let always_false: BoxBiPredicate<i32, i32> = BoxBiPredicate::always_false();
30    println!("\nBoxBiPredicate::always_false():");
31    println!("  test(&42, &10): {}", always_false.test(&42, &10));
32    println!("  test(&-1, &5): {}", always_false.test(&-1, &5));
33    println!("  test(&0, &0): {}", always_false.test(&0, &0));
34    println!("  name: {:?}", always_false.name());
35
36    println!("\n=== RcBiPredicate always_true/always_false Demo ===\n");
37
38    // RcBiPredicate::always_true
39    let rc_always_true: RcBiPredicate<String, i32> = RcBiPredicate::always_true();
40    println!("RcBiPredicate::always_true():");
41    println!(
42        "  test(&\"hello\", &5): {}",
43        rc_always_true.test(&"hello".to_string(), &5)
44    );
45    println!(
46        "  test(&\"world\", &-3): {}",
47        rc_always_true.test(&"world".to_string(), &-3)
48    );
49    println!("  name: {:?}", rc_always_true.name());
50
51    // RcBiPredicate::always_false
52    let rc_always_false: RcBiPredicate<String, i32> = RcBiPredicate::always_false();
53    println!("\nRcBiPredicate::always_false():");
54    println!(
55        "  test(&\"hello\", &5): {}",
56        rc_always_false.test(&"hello".to_string(), &5)
57    );
58    println!(
59        "  test(&\"world\", &-3): {}",
60        rc_always_false.test(&"world".to_string(), &-3)
61    );
62    println!("  name: {:?}", rc_always_false.name());
63
64    // Can be cloned and reused
65    let rc_clone = rc_always_true.clone();
66    println!("\nAfter cloning, still usable:");
67    println!(
68        "  Original: test(&\"test\", &1): {}",
69        rc_always_true.test(&"test".to_string(), &1)
70    );
71    println!(
72        "  Clone: test(&\"test\", &2): {}",
73        rc_clone.test(&"test".to_string(), &2)
74    );
75
76    println!("\n=== ArcBiPredicate always_true/always_false Demo ===\n");
77
78    // ArcBiPredicate::always_true
79    let arc_always_true: ArcBiPredicate<i32, i32> = ArcBiPredicate::always_true();
80    println!("ArcBiPredicate::always_true():");
81    println!("  test(&100, &50): {}", arc_always_true.test(&100, &50));
82    println!("  test(&-100, &25): {}", arc_always_true.test(&-100, &25));
83    println!("  name: {:?}", arc_always_true.name());
84
85    // ArcBiPredicate::always_false
86    let arc_always_false: ArcBiPredicate<i32, i32> = ArcBiPredicate::always_false();
87    println!("\nArcBiPredicate::always_false():");
88    println!("  test(&100, &50): {}", arc_always_false.test(&100, &50));
89    println!("  test(&-100, &25): {}", arc_always_false.test(&-100, &25));
90    println!("  name: {:?}", arc_always_false.name());
91
92    println!("\n=== Combining with other bi-predicates ===\n");
93
94    // Combining with always_true (AND)
95    let sum_positive = BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
96    let combined_and_true = sum_positive.and(BoxBiPredicate::always_true());
97    println!("sum_positive AND always_true:");
98    println!(
99        "  test(&5, &3): {} (equivalent to sum_positive)",
100        combined_and_true.test(&5, &3)
101    );
102    println!(
103        "  test(&-3, &-5): {} (equivalent to sum_positive)",
104        combined_and_true.test(&-3, &-5)
105    );
106
107    // Combining with always_false (AND)
108    let sum_positive = BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
109    let combined_and_false = sum_positive.and(BoxBiPredicate::always_false());
110    println!("\nsum_positive AND always_false:");
111    println!(
112        "  test(&5, &3): {} (always false)",
113        combined_and_false.test(&5, &3)
114    );
115    println!(
116        "  test(&-3, &-5): {} (always false)",
117        combined_and_false.test(&-3, &-5)
118    );
119
120    // Combining with always_true (OR)
121    let sum_positive = BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
122    let combined_or_true = sum_positive.or(BoxBiPredicate::always_true());
123    println!("\nsum_positive OR always_true:");
124    println!(
125        "  test(&5, &3): {} (always true)",
126        combined_or_true.test(&5, &3)
127    );
128    println!(
129        "  test(&-3, &-5): {} (always true)",
130        combined_or_true.test(&-3, &-5)
131    );
132
133    // Combining with always_false (OR)
134    let sum_positive = BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 0);
135    let combined_or_false = sum_positive.or(BoxBiPredicate::always_false());
136    println!("\nsum_positive OR always_false:");
137    println!(
138        "  test(&5, &3): {} (equivalent to sum_positive)",
139        combined_or_false.test(&5, &3)
140    );
141    println!(
142        "  test(&-3, &-5): {} (equivalent to sum_positive)",
143        combined_or_false.test(&-3, &-5)
144    );
145
146    println!("\n=== Practical scenarios: Default pass/reject filters ===\n");
147
148    // Scenario 1: Default pass-all filter
149    let pairs = vec![(1, 2), (3, 4), (5, 6)];
150    let pass_all = BoxBiPredicate::<i32, i32>::always_true();
151    let closure = pass_all.into_fn();
152    let filtered: Vec<_> = pairs.iter().filter(|(x, y)| closure(x, y)).collect();
153    println!("Default pass all elements: {:?} -> {:?}", pairs, filtered);
154
155    // Scenario 2: Default reject-all filter
156    let pairs = vec![(1, 2), (3, 4), (5, 6)];
157    let reject_all = BoxBiPredicate::<i32, i32>::always_false();
158    let closure = reject_all.into_fn();
159    let filtered: Vec<_> = pairs.iter().filter(|(x, y)| closure(x, y)).collect();
160    println!("Default reject all elements: {:?} -> {:?}", pairs, filtered);
161
162    // Scenario 3: Configurable filter
163    fn configurable_filter(enable_filter: bool) -> BoxBiPredicate<i32, i32> {
164        if enable_filter {
165            BoxBiPredicate::new(|x: &i32, y: &i32| x + y > 5)
166        } else {
167            BoxBiPredicate::always_true()
168        }
169    }
170
171    let pairs = vec![(1, 2), (3, 4), (5, 6)];
172
173    let filter_enabled = configurable_filter(true);
174    let closure = filter_enabled.into_fn();
175    let filtered: Vec<_> = pairs.iter().filter(|(x, y)| closure(x, y)).collect();
176    println!("\nFilter enabled: {:?} -> {:?}", pairs, filtered);
177
178    let filter_disabled = configurable_filter(false);
179    let closure = filter_disabled.into_fn();
180    let filtered: Vec<_> = pairs.iter().filter(|(x, y)| closure(x, y)).collect();
181    println!("Filter disabled: {:?} -> {:?}", pairs, filtered);
182}
Source

pub fn and<P>(&self, other: P) -> ArcBiPredicate<T, U>
where T: 'static, U: 'static, P: BiPredicate<T, U> + Send + Sync + 'static,

Returns a bi-predicate that represents the logical AND of this bi-predicate and another.

This method consumes self due to single-ownership semantics.

§Parameters
  • other - The other bi-predicate to combine with.
§Returns

A new bi-predicate representing the logical AND.

Source

pub fn or<P>(&self, other: P) -> ArcBiPredicate<T, U>
where T: 'static, U: 'static, P: BiPredicate<T, U> + Send + Sync + 'static,

Returns a bi-predicate that represents the logical OR of this bi-predicate and another.

This method consumes self due to single-ownership semantics.

§Parameters
  • other - The other bi-predicate to combine with.
§Returns

A new bi-predicate representing the logical OR.

Source

pub fn not(&self) -> ArcBiPredicate<T, U>
where T: 'static, U: 'static,

Returns a bi-predicate that represents the logical negation of this bi-predicate.

This method consumes self due to single-ownership semantics.

§Returns

A new bi-predicate representing the logical negation.

Source

pub fn nand<P>(&self, other: P) -> ArcBiPredicate<T, U>
where T: 'static, U: 'static, P: BiPredicate<T, U> + Send + Sync + 'static,

Returns a bi-predicate that represents the logical NAND (NOT AND) of this bi-predicate and another.

NAND returns true unless both bi-predicates are true. Equivalent to !(self AND other).

This method consumes self due to single-ownership semantics.

§Parameters
  • other - The other bi-predicate to combine with.
§Returns

A new bi-predicate representing the logical NAND.

Source

pub fn xor<P>(&self, other: P) -> ArcBiPredicate<T, U>
where T: 'static, U: 'static, P: BiPredicate<T, U> + Send + Sync + 'static,

Returns a bi-predicate that represents the logical XOR (exclusive OR) of this bi-predicate and another.

XOR returns true if exactly one of the bi-predicates is true.

This method consumes self due to single-ownership semantics.

§Parameters
  • other - The other bi-predicate to combine with.
§Returns

A new bi-predicate representing the logical XOR.

Source

pub fn nor<P>(&self, other: P) -> ArcBiPredicate<T, U>
where T: 'static, U: 'static, P: BiPredicate<T, U> + Send + Sync + 'static,

Returns a bi-predicate that represents the logical NOR (NOT OR) of this bi-predicate and another.

NOR returns true only when both bi-predicates are false. Equivalent to !(self OR other).

This method consumes self due to single-ownership semantics.

§Parameters
  • other - The other bi-predicate to combine with.
§Returns

A new bi-predicate representing the logical NOR.

Trait Implementations§

Source§

impl<T, U> BiPredicate<T, U> for ArcBiPredicate<T, U>

Source§

fn test(&self, first: &T, second: &U) -> bool

Tests whether the given values satisfy this bi-predicate. Read more
Source§

fn into_box(self) -> BoxBiPredicate<T, U>
where Self: 'static,

Converts this bi-predicate into a BoxBiPredicate. Read more
Source§

fn into_rc(self) -> RcBiPredicate<T, U>
where Self: 'static,

Converts this bi-predicate into an RcBiPredicate. Read more
Source§

fn into_arc(self) -> ArcBiPredicate<T, U>

Converts this bi-predicate into an ArcBiPredicate. Read more
Source§

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

Converts this bi-predicate into a closure that can be used directly with standard library methods. Read more
Source§

fn to_box(&self) -> BoxBiPredicate<T, U>
where Self: 'static,

Source§

fn to_rc(&self) -> RcBiPredicate<T, U>
where Self: 'static,

Source§

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

Source§

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

Source§

impl<T, U> Clone for ArcBiPredicate<T, U>

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<T, U> Debug for ArcBiPredicate<T, U>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T, U> Display for ArcBiPredicate<T, U>

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<T, U> Freeze for ArcBiPredicate<T, U>

§

impl<T, U> !RefUnwindSafe for ArcBiPredicate<T, U>

§

impl<T, U> Send for ArcBiPredicate<T, U>

§

impl<T, U> Sync for ArcBiPredicate<T, U>

§

impl<T, U> Unpin for ArcBiPredicate<T, U>

§

impl<T, U> UnsafeUnpin for ArcBiPredicate<T, U>

§

impl<T, U> !UnwindSafe for ArcBiPredicate<T, U>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.