contain 0.4.0

A crate for defining/extending lifetimes
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

# contain-rs

A crate for defining/extending lifetimes.

## Examples

### Simple Container

A basic fast implementation of `Container` backed by `Vec`.

```rust
use contain::{Container, SimpleContainer};

fn append_thing<'a>(container: &'a impl Container<String>, s: &str) -> &'a str {
    container.put(format!("{}thing", s))
}

let container = SimpleContainer::new();
let a = append_thing(&container, "some");
let b = append_thing(&container, "a ");
let c = append_thing(&container, "that ");
assert_eq!(a, "something");
assert_eq!(b, "a thing");
assert_eq!(c, "that thing");
assert_eq!(container.len(), 3)
```

## Deduplicating Container

A deduplicating `Container` backed by a `std::collections::HashSet`.
If two equal items are stored, the second is dropped
and a reference to the first is returned.
Whilst more resource-intensive than `SimpleContainer`, it can be more memory efficient in scenarios where many
items are equal and equivalent since the duplicates will be dropped.

```rust
use contain::{Container, DeduplicatingContainer};

fn append_thing<'a>(container: &'a impl Container<String>, s: &str) -> &'a str {
    container.put(format!("{}thing", s))
}

let container = DeduplicatingContainer::new();
let a = append_thing(&container, "some");
let b = append_thing(&container, "a ");
let c = append_thing(&container, "some");
assert_eq!(a, "something");
assert_eq!(b, "a thing");
assert_eq!(c, "something");
assert_eq!(container.len(), 2);
 ```