#string #cache #servo #interning

string_cache

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

58 releases

0.7.3 Jun 5, 2018
0.7.1 Dec 4, 2017
0.7.0 Oct 24, 2017
0.6.1 Jul 7, 2017
0.1.10 Jul 30, 2015

#3 in Caching

Download history 9856/week @ 2018-07-01 8672/week @ 2018-07-08 9538/week @ 2018-07-15 9849/week @ 2018-07-22 8791/week @ 2018-07-29 10546/week @ 2018-08-05 9280/week @ 2018-08-12 9213/week @ 2018-08-19 8544/week @ 2018-08-26 7783/week @ 2018-09-02 7852/week @ 2018-09-09 8168/week @ 2018-09-16 8013/week @ 2018-09-23

27,354 downloads per month
Used in 138 crates (17 directly)

MIT/Apache

44KB
923 lines

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.7"

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.7"

[build-dependencies]
string_cache_codegen = "0.4"

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,
    }
}

Dependencies

~466KB