arc-cell 0.2.2

Helper for a simple Cell-like object containing Arc/Weak
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

# arc-cell

[Documentation](https://docs.rs/arc-cell/)

A simple library for a concurrent Cell-like object containing an Arc/Weak reference.

```toml
[dependencies]
arc-cell = "0.2"
```

# Usage

### Lightweight swappable Arc member

```rust
use std::sync::Arc;
use arc_cell::ArcCell;

pub struct Thing {
    data: ArcCell<Vec<u8>>,
}

impl Thing {
    pub fn update(&self, data: Arc<Vec<u8>>) {
        self.data.set(Some(data));
    }
}
```

### Self-referencial structure

```rust
use std::sync::Arc;
use arc_cell::WeakCell;

pub struct Thing {
    self_ref: WeakCell<Thing>,
    // ...
}

impl Thing {
    pub fn new() -> Arc<Thing> {
        let thing = Arc::new(Thing {
            self_ref: WeakCell::new(None),
        });
        
        thing.self_ref.store(&thing);
        thing
    }
    
    pub fn clone_ref(&self) -> Arc<Thing> {
        self.self_ref.upgrade().expect("This should be valid if we have a valid self")
    }
}
```