atum 0.1.0

Lock-free bidirectional Atom Table, optimized for multi-threaded workloads
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

# `atum`

Lock-free bidirectional Atom Table, optimized for maximum performance in multi-threaded workloads.

Designed for compilers, interpreters, and any system that needs fast, concurrent string interning.

## Example
```rust
use atum::AtomTable;

let tbl = AtomTable::new();
let atom = tbl.intern("Hello, Sailor!");

assert_eq!(tbl.lookup_ref(atom).as_ref(), "Hello, Sailor!");
assert_eq!(tbl.intern("Hello, Sailor!"), atom);

let guard = tbl.pin();
let strings = &[
    "unfortunately", "there's", "a",
    "radio", "connected", "to", "my", "brain"
];
for &s in strings {
    let atom = tbl.intern_with_guard(s, &guard);
    assert_eq!(tbl.lookup_ref(atom).as_ref(), s);
    assert_eq!(tbl.intern_with_guard(s, &guard), atom);
}
```

# Why `atum`?
> Benchmarks are going to be here soon ..

# NOTICE
> This is the first version of atum. It doesn’t yet include all advanced optimizations, but it’s already as fast or faster than `lasso` in multithreaded scenarios. Future updates may improve performance further.
> Also: the naming is experimental, it might change.

# License

MIT OR Apache-2.0