graph-arena

Crates.iograph-arena
lib.rsgraph-arena
version0.1.0
sourcesrc
created_at2020-11-13 14:34:10.371045
updated_at2020-11-13 14:34:10.371045
descriptionCollection type to store immutable graph structures efficiently
homepage
repositoryhttps://github.com/nilsmartel/graph-arena
max_upload_size
id311958
size4,121
Nils Martel (nilsmartel)

documentation

README

Graph Arena

Collection type to store immutable graph data efficiently. Avoids heap clusturing, enforces locality and reduces the need for copying all together.

When should I use this?

In recursive data structures, one often encounters code like this:

struct Expression {
    Add(Box<Expression>, Box<Expression>),
    // ...
}

In the long run one encounters several problems with this approach:

  • Most data lives on the heap, but related data aren't necessarily near each other.
  • A lot of allocations are required to build these structures.
  • Cloning becomes really expensive.

Now, allocations are something we'd like to avoid as much as possible; alloc is an expensive operation. That's why a Vec<T> allocates more memory, than it (might) use. So no reallocation of data is required each time we push more data.

Furthermore we desire related data to live in near by memory locations: Modern CPUs are heavily modified to take advantage of locality, that makes Vec<T> an insanely fast data strucutre!

Commit count: 6

cargo fmt