WeakArcmo

Struct WeakArcmo 

Source
pub struct WeakArcmo<T: Clone> { /* private fields */ }
Expand description

A weak reference wrapper for Arcmo

Implementations§

Source§

impl<T: Clone> WeakArcmo<T>

Source

pub fn modify<F, R>(&self, f: F) -> Option<R>
where T: Default, F: FnOnce(&mut T) -> R,

Attempts to modify the value if it exists and the original Arcmo still exists

Examples found in repository?
examples/arcmo_example.rs (line 48)
3fn main() {
4    println!("=== Creating Arcmo instances ===");
5    // Create with Some value
6    let v = Arcmo::some(42);
7    println!("Created with some: v = {:?}", v);
8
9    // Create with Default (None)
10    let default: Arcmo<i32> = Arcmo::default();
11    println!("Created with default: default = {:?}", default);
12
13    // Create explicitly as None
14    let none: Arcmo<i32> = Arcmo::none();
15    println!("Created as none: none = {:?}", none);
16
17    println!("\n=== Basic value operations ===");
18    println!("v.value() = {:?}", v.value());
19    println!("v.is_some() = {}", v.is_some());
20    println!("v.is_none() = {}", v.is_none());
21
22    println!("\n=== Modification ===");
23    // Modify existing value
24    v.modify(|x| *x += 1);
25    println!("After v += 1: {:?}", v.value());
26
27    v.modify(|x| *x *= 2);
28    println!("After v *= 2: {:?}", v.value());
29
30    // Try to modify None (should have no effect)
31    none.modify(|x| *x = 100);
32    println!("After trying to modify None: {:?}", none.value());
33
34    println!("\n=== Multiple references ===");
35    let v2 = v.clone();
36    v.modify(|x| *x += 5);
37    println!("Modified through v: {:?}", v.value());
38    println!("Observed through v2: {:?}", v2.value());
39
40    println!("\n=== Weak references ===");
41    let weak = v.downgrade();
42    println!("Weak reference: {:?}", weak);
43    println!("weak.value() = {:?}", weak.value());
44    println!("weak.is_some() = {}", weak.is_some());
45    println!("weak.is_none() = {}", weak.is_none());
46
47    // Modify through weak reference
48    weak.modify(|x| *x += 10);
49    println!("\nAfter weak modify:");
50    println!("Observed through strong ref: {:?}", v.value());
51    println!("Observed through weak ref: {:?}", weak.value());
52
53    println!("\n=== Take and Replace operations ===");
54    println!("Taking value from v: {:?}", v.take());
55    println!("After take:");
56    println!("v.is_none() = {}", v.is_none());
57    println!("weak.is_none() = {}", weak.is_none());
58
59    println!("\nReplacing with new value:");
60    let previous = v.replace(100);
61    println!("Previous value: {:?}", previous);
62    println!("New value through v: {:?}", v.value());
63    println!("New value through weak: {:?}", weak.value());
64
65    println!("\n=== Weak reference behavior when strong ref is dropped ===");
66    {
67        let temp = Arcmo::some(999);
68        let weak_temp = temp.downgrade();
69        println!("Before drop - weak_temp.value() = {:?}", weak_temp.value());
70        drop(temp);
71        println!("After drop - weak_temp.value() = {:?}", weak_temp.value());
72    }
73
74    println!("\n=== Complex type example ===");
75    let vec_arcmo = Arcmo::some(vec![1, 2, 3]);
76    println!("Vector Arcmo: {:?}", vec_arcmo);
77
78    vec_arcmo.modify(|v| v.push(4));
79    println!("After push: {:?}", vec_arcmo.value());
80
81    let weak_vec = vec_arcmo.downgrade();
82    weak_vec.modify(|v| v.extend_from_slice(&[5, 6]));
83    println!("After weak modify: {:?}", vec_arcmo.value());
84
85    println!("\n=== Default for different types ===");
86    let default_vec: Arcmo<Vec<i32>> = Arcmo::default();
87    let default_string: Arcmo<String> = Arcmo::default();
88    println!("Default Vec<i32>: {:?}", default_vec);
89    println!("Default String: {:?}", default_string);
90}
Source

pub fn value(&self) -> Option<T>

Attempts to get a copy of the value if it exists and the original Arcmo still exists

Examples found in repository?
examples/arcmo_example.rs (line 43)
3fn main() {
4    println!("=== Creating Arcmo instances ===");
5    // Create with Some value
6    let v = Arcmo::some(42);
7    println!("Created with some: v = {:?}", v);
8
9    // Create with Default (None)
10    let default: Arcmo<i32> = Arcmo::default();
11    println!("Created with default: default = {:?}", default);
12
13    // Create explicitly as None
14    let none: Arcmo<i32> = Arcmo::none();
15    println!("Created as none: none = {:?}", none);
16
17    println!("\n=== Basic value operations ===");
18    println!("v.value() = {:?}", v.value());
19    println!("v.is_some() = {}", v.is_some());
20    println!("v.is_none() = {}", v.is_none());
21
22    println!("\n=== Modification ===");
23    // Modify existing value
24    v.modify(|x| *x += 1);
25    println!("After v += 1: {:?}", v.value());
26
27    v.modify(|x| *x *= 2);
28    println!("After v *= 2: {:?}", v.value());
29
30    // Try to modify None (should have no effect)
31    none.modify(|x| *x = 100);
32    println!("After trying to modify None: {:?}", none.value());
33
34    println!("\n=== Multiple references ===");
35    let v2 = v.clone();
36    v.modify(|x| *x += 5);
37    println!("Modified through v: {:?}", v.value());
38    println!("Observed through v2: {:?}", v2.value());
39
40    println!("\n=== Weak references ===");
41    let weak = v.downgrade();
42    println!("Weak reference: {:?}", weak);
43    println!("weak.value() = {:?}", weak.value());
44    println!("weak.is_some() = {}", weak.is_some());
45    println!("weak.is_none() = {}", weak.is_none());
46
47    // Modify through weak reference
48    weak.modify(|x| *x += 10);
49    println!("\nAfter weak modify:");
50    println!("Observed through strong ref: {:?}", v.value());
51    println!("Observed through weak ref: {:?}", weak.value());
52
53    println!("\n=== Take and Replace operations ===");
54    println!("Taking value from v: {:?}", v.take());
55    println!("After take:");
56    println!("v.is_none() = {}", v.is_none());
57    println!("weak.is_none() = {}", weak.is_none());
58
59    println!("\nReplacing with new value:");
60    let previous = v.replace(100);
61    println!("Previous value: {:?}", previous);
62    println!("New value through v: {:?}", v.value());
63    println!("New value through weak: {:?}", weak.value());
64
65    println!("\n=== Weak reference behavior when strong ref is dropped ===");
66    {
67        let temp = Arcmo::some(999);
68        let weak_temp = temp.downgrade();
69        println!("Before drop - weak_temp.value() = {:?}", weak_temp.value());
70        drop(temp);
71        println!("After drop - weak_temp.value() = {:?}", weak_temp.value());
72    }
73
74    println!("\n=== Complex type example ===");
75    let vec_arcmo = Arcmo::some(vec![1, 2, 3]);
76    println!("Vector Arcmo: {:?}", vec_arcmo);
77
78    vec_arcmo.modify(|v| v.push(4));
79    println!("After push: {:?}", vec_arcmo.value());
80
81    let weak_vec = vec_arcmo.downgrade();
82    weak_vec.modify(|v| v.extend_from_slice(&[5, 6]));
83    println!("After weak modify: {:?}", vec_arcmo.value());
84
85    println!("\n=== Default for different types ===");
86    let default_vec: Arcmo<Vec<i32>> = Arcmo::default();
87    let default_string: Arcmo<String> = Arcmo::default();
88    println!("Default Vec<i32>: {:?}", default_vec);
89    println!("Default String: {:?}", default_string);
90}
Source

pub fn is_some(&self) -> bool

Returns true if both the original Arcmo exists and contains Some value

Examples found in repository?
examples/arcmo_example.rs (line 44)
3fn main() {
4    println!("=== Creating Arcmo instances ===");
5    // Create with Some value
6    let v = Arcmo::some(42);
7    println!("Created with some: v = {:?}", v);
8
9    // Create with Default (None)
10    let default: Arcmo<i32> = Arcmo::default();
11    println!("Created with default: default = {:?}", default);
12
13    // Create explicitly as None
14    let none: Arcmo<i32> = Arcmo::none();
15    println!("Created as none: none = {:?}", none);
16
17    println!("\n=== Basic value operations ===");
18    println!("v.value() = {:?}", v.value());
19    println!("v.is_some() = {}", v.is_some());
20    println!("v.is_none() = {}", v.is_none());
21
22    println!("\n=== Modification ===");
23    // Modify existing value
24    v.modify(|x| *x += 1);
25    println!("After v += 1: {:?}", v.value());
26
27    v.modify(|x| *x *= 2);
28    println!("After v *= 2: {:?}", v.value());
29
30    // Try to modify None (should have no effect)
31    none.modify(|x| *x = 100);
32    println!("After trying to modify None: {:?}", none.value());
33
34    println!("\n=== Multiple references ===");
35    let v2 = v.clone();
36    v.modify(|x| *x += 5);
37    println!("Modified through v: {:?}", v.value());
38    println!("Observed through v2: {:?}", v2.value());
39
40    println!("\n=== Weak references ===");
41    let weak = v.downgrade();
42    println!("Weak reference: {:?}", weak);
43    println!("weak.value() = {:?}", weak.value());
44    println!("weak.is_some() = {}", weak.is_some());
45    println!("weak.is_none() = {}", weak.is_none());
46
47    // Modify through weak reference
48    weak.modify(|x| *x += 10);
49    println!("\nAfter weak modify:");
50    println!("Observed through strong ref: {:?}", v.value());
51    println!("Observed through weak ref: {:?}", weak.value());
52
53    println!("\n=== Take and Replace operations ===");
54    println!("Taking value from v: {:?}", v.take());
55    println!("After take:");
56    println!("v.is_none() = {}", v.is_none());
57    println!("weak.is_none() = {}", weak.is_none());
58
59    println!("\nReplacing with new value:");
60    let previous = v.replace(100);
61    println!("Previous value: {:?}", previous);
62    println!("New value through v: {:?}", v.value());
63    println!("New value through weak: {:?}", weak.value());
64
65    println!("\n=== Weak reference behavior when strong ref is dropped ===");
66    {
67        let temp = Arcmo::some(999);
68        let weak_temp = temp.downgrade();
69        println!("Before drop - weak_temp.value() = {:?}", weak_temp.value());
70        drop(temp);
71        println!("After drop - weak_temp.value() = {:?}", weak_temp.value());
72    }
73
74    println!("\n=== Complex type example ===");
75    let vec_arcmo = Arcmo::some(vec![1, 2, 3]);
76    println!("Vector Arcmo: {:?}", vec_arcmo);
77
78    vec_arcmo.modify(|v| v.push(4));
79    println!("After push: {:?}", vec_arcmo.value());
80
81    let weak_vec = vec_arcmo.downgrade();
82    weak_vec.modify(|v| v.extend_from_slice(&[5, 6]));
83    println!("After weak modify: {:?}", vec_arcmo.value());
84
85    println!("\n=== Default for different types ===");
86    let default_vec: Arcmo<Vec<i32>> = Arcmo::default();
87    let default_string: Arcmo<String> = Arcmo::default();
88    println!("Default Vec<i32>: {:?}", default_vec);
89    println!("Default String: {:?}", default_string);
90}
Source

pub fn is_none(&self) -> bool

Returns true if either the original Arcmo is dropped or contains None

Examples found in repository?
examples/arcmo_example.rs (line 45)
3fn main() {
4    println!("=== Creating Arcmo instances ===");
5    // Create with Some value
6    let v = Arcmo::some(42);
7    println!("Created with some: v = {:?}", v);
8
9    // Create with Default (None)
10    let default: Arcmo<i32> = Arcmo::default();
11    println!("Created with default: default = {:?}", default);
12
13    // Create explicitly as None
14    let none: Arcmo<i32> = Arcmo::none();
15    println!("Created as none: none = {:?}", none);
16
17    println!("\n=== Basic value operations ===");
18    println!("v.value() = {:?}", v.value());
19    println!("v.is_some() = {}", v.is_some());
20    println!("v.is_none() = {}", v.is_none());
21
22    println!("\n=== Modification ===");
23    // Modify existing value
24    v.modify(|x| *x += 1);
25    println!("After v += 1: {:?}", v.value());
26
27    v.modify(|x| *x *= 2);
28    println!("After v *= 2: {:?}", v.value());
29
30    // Try to modify None (should have no effect)
31    none.modify(|x| *x = 100);
32    println!("After trying to modify None: {:?}", none.value());
33
34    println!("\n=== Multiple references ===");
35    let v2 = v.clone();
36    v.modify(|x| *x += 5);
37    println!("Modified through v: {:?}", v.value());
38    println!("Observed through v2: {:?}", v2.value());
39
40    println!("\n=== Weak references ===");
41    let weak = v.downgrade();
42    println!("Weak reference: {:?}", weak);
43    println!("weak.value() = {:?}", weak.value());
44    println!("weak.is_some() = {}", weak.is_some());
45    println!("weak.is_none() = {}", weak.is_none());
46
47    // Modify through weak reference
48    weak.modify(|x| *x += 10);
49    println!("\nAfter weak modify:");
50    println!("Observed through strong ref: {:?}", v.value());
51    println!("Observed through weak ref: {:?}", weak.value());
52
53    println!("\n=== Take and Replace operations ===");
54    println!("Taking value from v: {:?}", v.take());
55    println!("After take:");
56    println!("v.is_none() = {}", v.is_none());
57    println!("weak.is_none() = {}", weak.is_none());
58
59    println!("\nReplacing with new value:");
60    let previous = v.replace(100);
61    println!("Previous value: {:?}", previous);
62    println!("New value through v: {:?}", v.value());
63    println!("New value through weak: {:?}", weak.value());
64
65    println!("\n=== Weak reference behavior when strong ref is dropped ===");
66    {
67        let temp = Arcmo::some(999);
68        let weak_temp = temp.downgrade();
69        println!("Before drop - weak_temp.value() = {:?}", weak_temp.value());
70        drop(temp);
71        println!("After drop - weak_temp.value() = {:?}", weak_temp.value());
72    }
73
74    println!("\n=== Complex type example ===");
75    let vec_arcmo = Arcmo::some(vec![1, 2, 3]);
76    println!("Vector Arcmo: {:?}", vec_arcmo);
77
78    vec_arcmo.modify(|v| v.push(4));
79    println!("After push: {:?}", vec_arcmo.value());
80
81    let weak_vec = vec_arcmo.downgrade();
82    weak_vec.modify(|v| v.extend_from_slice(&[5, 6]));
83    println!("After weak modify: {:?}", vec_arcmo.value());
84
85    println!("\n=== Default for different types ===");
86    let default_vec: Arcmo<Vec<i32>> = Arcmo::default();
87    let default_string: Arcmo<String> = Arcmo::default();
88    println!("Default Vec<i32>: {:?}", default_vec);
89    println!("Default String: {:?}", default_string);
90}
Source

pub fn replace(&self, value: T) -> Option<Option<T>>

Attempts to replace the value if the original Arcmo still exists

Trait Implementations§

Source§

impl<T: Clone> Debug for WeakArcmo<T>

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<T> Freeze for WeakArcmo<T>

§

impl<T> RefUnwindSafe for WeakArcmo<T>

§

impl<T> Send for WeakArcmo<T>
where T: Send,

§

impl<T> Sync for WeakArcmo<T>
where T: Send,

§

impl<T> Unpin for WeakArcmo<T>

§

impl<T> UnwindSafe for WeakArcmo<T>

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> 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, 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.