#string-cache #string-interning #share #servo #string-cache-codegen

string_cache_shared

Code share between string_cache and string_cache_codegen

13 releases

Uses old Rust 2015

0.3.0 Nov 2, 2016
0.1.12 Nov 13, 2015
0.1.9 Oct 26, 2015
0.1.7 Sep 13, 2015
0.1.0 Apr 29, 2015

#209 in Caching

Download history 2413/week @ 2025-03-10 3949/week @ 2025-03-17 2050/week @ 2025-03-24 3031/week @ 2025-03-31 5343/week @ 2025-04-07 3436/week @ 2025-04-14 3344/week @ 2025-04-21 3862/week @ 2025-04-28 2078/week @ 2025-05-05 1914/week @ 2025-05-12 1885/week @ 2025-05-19 1526/week @ 2025-05-26 1615/week @ 2025-06-02 2148/week @ 2025-06-09 3097/week @ 2025-06-16 2491/week @ 2025-06-23

9,435 downloads per month
Used in 234 crates (via string_cache_plugin)

MIT/Apache

2KB

string-cache

Build Status

Documentation

A string interning library for Rust, developed as part of the Servo project.

Simple usage

In Cargo.toml:

[dependencies]
string_cache = "0.8"

In lib.rs:

extern crate string_cache;
use string_cache::DefaultAtom as Atom;

With static atoms

In Cargo.toml:

[package]
build = "build.rs"

[dependencies]
string_cache = "0.8"

[build-dependencies]
string_cache_codegen = "0.5"

In build.rs:

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:

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:

fn compute_something(input: &foo::FooAtom) -> u32 {
    match *input {
        foo_atom!("foo") => 1,
        foo_atom!("bar") => 2,
        _ => 3,
    }
}

No runtime deps