blob: fdf4c0a35b3029c81573dfd6a5946150746c2780 (
plain)
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
# string-cache
[](https://github.com/servo/string-cache/actions)
[Documentation](https://docs.rs/string_cache/)
A string interning library for Rust, developed as part of the [Servo](https://github.com/servo/servo) project.
## Simple usage
In `Cargo.toml`:
```toml
[dependencies]
string_cache = "0.8"
```
In `lib.rs`:
```rust
extern crate string_cache;
use string_cache::DefaultAtom as Atom;
```
## With static atoms
In `Cargo.toml`:
```toml
[package]
build = "build.rs"
[dependencies]
string_cache = "0.8"
[build-dependencies]
string_cache_codegen = "0.5"
```
In `build.rs`:
```rust
extern crate string_cache_codegen;
use std::env;
use std::path::Path;
fn main() {
string_cache_codegen::AtomType::new("foo::FooAtom", "foo_atom!")
.atoms(&["foo", "bar"])
.write_to_file(&Path::new(&env::var("OUT_DIR").unwrap()).join("foo_atom.rs"))
.unwrap()
}
```
In `lib.rs`:
```rust
extern crate string_cache;
mod foo {
include!(concat!(env!("OUT_DIR"), "/foo_atom.rs"));
}
```
The generated code will define a `FooAtom` type and a `foo_atom!` macro.
The macro can be used in expression or patterns, with strings listed in `build.rs`.
For example:
```rust
fn compute_something(input: &foo::FooAtom) -> u32 {
match *input {
foo_atom!("foo") => 1,
foo_atom!("bar") => 2,
_ => 3,
}
}
```
|
