#tree #tree-traversal #arena #reference-counting #index #trie

no-std indextree

Arena based tree structure by using indices instead of reference counted pointers

26 stable releases (4 major)

4.7.3 Oct 21, 2024
4.7.0 Jul 30, 2024
4.6.0 Mar 9, 2023
4.5.0 Sep 16, 2022
0.1.1 Dec 22, 2016

#34 in Data structures

Download history 7152/week @ 2024-07-31 7862/week @ 2024-08-07 6808/week @ 2024-08-14 7397/week @ 2024-08-21 6625/week @ 2024-08-28 7140/week @ 2024-09-04 5271/week @ 2024-09-11 6067/week @ 2024-09-18 7789/week @ 2024-09-25 4947/week @ 2024-10-02 6396/week @ 2024-10-09 7837/week @ 2024-10-16 6509/week @ 2024-10-23 6542/week @ 2024-10-30 6701/week @ 2024-11-06 5024/week @ 2024-11-13

26,011 downloads per month
Used in 109 crates (40 directly)

MIT license

120KB
1.5K SLoC

indextree

GitHub Actions Coverage Dependency Status Doc indextree License MIT Crates.io doc.rs

Arena based tree structure with multithreading support

This arena tree structure is using just a single Vec and numerical identifiers (indices in the vector) instead of reference counted pointers. This means there is no RefCell and mutability is handled in a way much more idiomatic to Rust through unique (&mut) access to the arena. The tree can be sent or shared across threads like a Vec. This enables general multiprocessing support like parallel tree traversals.

Example usage

use indextree::Arena;

// Create a new arena
let arena = &mut Arena::new();

// Add some new nodes to the arena
let a = arena.new_node(1);
let b = arena.new_node(2);

// Append a to b
assert!(a.append(b, arena).is_ok());
assert_eq!(b.ancestors(arena).into_iter().count(), 2);

Benchmarks

https://github.com/mooman219/generational_arena_bench

Dependencies

~0–500KB
~10K SLoC