//! Yet another index-based arena. #![warn(missing_docs)] use std::{ fmt, hash::{Hash, Hasher}, iter::FromIterator, marker::PhantomData, ops::{Index, IndexMut, Range, RangeInclusive}, }; mod map; pub use map::ArenaMap; /// The raw index of a value in an arena. #[derive(Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)] pub struct RawIdx(u32); impl From for u32 { fn from(raw: RawIdx) -> u32 { raw.0 } } impl From for RawIdx { fn from(idx: u32) -> RawIdx { RawIdx(idx) } } impl fmt::Debug for RawIdx { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { self.0.fmt(f) } } impl fmt::Display for RawIdx { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { self.0.fmt(f) } } /// The index of a value allocated in an arena that holds `T`s. pub struct Idx { raw: RawIdx, _ty: PhantomData T>, } impl Clone for Idx { fn clone(&self) -> Self { *self } } impl Copy for Idx {} impl PartialEq for Idx { fn eq(&self, other: &Idx) -> bool { self.raw == other.raw } } impl Eq for Idx {} impl Hash for Idx { fn hash(&self, state: &mut H) { self.raw.hash(state); } } impl fmt::Debug for Idx { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { let mut type_name = std::any::type_name::(); if let Some(idx) = type_name.rfind(':') { type_name = &type_name[idx + 1..]; } write!(f, "Idx::<{}>({})", type_name, self.raw) } } impl Idx { /// Creates a new index from a [`RawIdx`]. pub fn from_raw(raw: RawIdx) -> Self { Idx { raw, _ty: PhantomData } } /// Converts this index into the underlying [`RawIdx`]. pub fn into_raw(self) -> RawIdx { self.raw } } /// A range of densely allocated arena values. pub struct IdxRange { range: Range, _p: PhantomData, } impl IdxRange { /// Creates a new index range /// inclusive of the start value and exclusive of the end value. /// /// ``` /// let mut arena = la_arena::Arena::new(); /// let a = arena.alloc("a"); /// let b = arena.alloc("b"); /// let c = arena.alloc("c"); /// let d = arena.alloc("d"); /// /// let range = la_arena::IdxRange::new(b..d); /// assert_eq!(&arena[range], &["b", "c"]); /// ``` pub fn new(range: Range>) -> Self { Self { range: range.start.into_raw().into()..range.end.into_raw().into(), _p: PhantomData } } /// Creates a new index range /// inclusive of the start value and end value. /// /// ``` /// let mut arena = la_arena::Arena::new(); /// let foo = arena.alloc("foo"); /// let bar = arena.alloc("bar"); /// let baz = arena.alloc("baz"); /// /// let range = la_arena::IdxRange::new_inclusive(foo..=baz); /// assert_eq!(&arena[range], &["foo", "bar", "baz"]); /// /// let range = la_arena::IdxRange::new_inclusive(foo..=foo); /// assert_eq!(&arena[range], &["foo"]); /// ``` pub fn new_inclusive(range: RangeInclusive>) -> Self { Self { range: u32::from(range.start().into_raw())..u32::from(range.end().into_raw()) + 1, _p: PhantomData, } } /// Returns whether the index range is empty. /// /// ``` /// let mut arena = la_arena::Arena::new(); /// let one = arena.alloc(1); /// let two = arena.alloc(2); /// /// assert!(la_arena::IdxRange::new(one..one).is_empty()); /// ``` pub fn is_empty(&self) -> bool { self.range.is_empty() } } impl Iterator for IdxRange { type Item = Idx; fn next(&mut self) -> Option { self.range.next().map(|raw| Idx::from_raw(raw.into())) } } impl DoubleEndedIterator for IdxRange { fn next_back(&mut self) -> Option { self.range.next_back().map(|raw| Idx::from_raw(raw.into())) } } impl fmt::Debug for IdxRange { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { f.debug_tuple(&format!("IdxRange::<{}>", std::any::type_name::())) .field(&self.range) .finish() } } impl Clone for IdxRange { fn clone(&self) -> Self { Self { range: self.range.clone(), _p: PhantomData } } } impl PartialEq for IdxRange { fn eq(&self, other: &Self) -> bool { self.range == other.range } } impl Eq for IdxRange {} /// Yet another index-based arena. #[derive(Clone, PartialEq, Eq, Hash)] pub struct Arena { data: Vec, } impl fmt::Debug for Arena { fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result { fmt.debug_struct("Arena").field("len", &self.len()).field("data", &self.data).finish() } } impl Arena { /// Creates a new empty arena. /// /// ``` /// let arena: la_arena::Arena = la_arena::Arena::new(); /// assert!(arena.is_empty()); /// ``` pub const fn new() -> Arena { Arena { data: Vec::new() } } /// Empties the arena, removing all contained values. /// /// ``` /// let mut arena = la_arena::Arena::new(); /// /// arena.alloc(1); /// arena.alloc(2); /// arena.alloc(3); /// assert_eq!(arena.len(), 3); /// /// arena.clear(); /// assert!(arena.is_empty()); /// ``` pub fn clear(&mut self) { self.data.clear(); } /// Returns the length of the arena. /// /// ``` /// let mut arena = la_arena::Arena::new(); /// assert_eq!(arena.len(), 0); /// /// arena.alloc("foo"); /// assert_eq!(arena.len(), 1); /// /// arena.alloc("bar"); /// assert_eq!(arena.len(), 2); /// /// arena.alloc("baz"); /// assert_eq!(arena.len(), 3); /// ``` pub fn len(&self) -> usize { self.data.len() } /// Returns whether the arena contains no elements. /// /// ``` /// let mut arena = la_arena::Arena::new(); /// assert!(arena.is_empty()); /// /// arena.alloc(0.5); /// assert!(!arena.is_empty()); /// ``` pub fn is_empty(&self) -> bool { self.data.is_empty() } /// Allocates a new value on the arena, returning the value’s index. /// /// ``` /// let mut arena = la_arena::Arena::new(); /// let idx = arena.alloc(50); /// /// assert_eq!(arena[idx], 50); /// ``` pub fn alloc(&mut self, value: T) -> Idx { let idx = self.next_idx(); self.data.push(value); idx } /// Returns an iterator over the arena’s elements. /// /// ``` /// let mut arena = la_arena::Arena::new(); /// let idx1 = arena.alloc(20); /// let idx2 = arena.alloc(40); /// let idx3 = arena.alloc(60); /// /// let mut iterator = arena.iter(); /// assert_eq!(iterator.next(), Some((idx1, &20))); /// assert_eq!(iterator.next(), Some((idx2, &40))); /// assert_eq!(iterator.next(), Some((idx3, &60))); /// ``` pub fn iter( &self, ) -> impl Iterator, &T)> + ExactSizeIterator + DoubleEndedIterator { self.data.iter().enumerate().map(|(idx, value)| (Idx::from_raw(RawIdx(idx as u32)), value)) } /// Returns an iterator over the arena’s mutable elements. /// /// ``` /// let mut arena = la_arena::Arena::new(); /// let idx1 = arena.alloc(20); /// /// assert_eq!(arena[idx1], 20); /// /// let mut iterator = arena.iter_mut(); /// *iterator.next().unwrap().1 = 10; /// drop(iterator); /// /// assert_eq!(arena[idx1], 10); /// ``` pub fn iter_mut( &mut self, ) -> impl Iterator, &mut T)> + ExactSizeIterator + DoubleEndedIterator { self.data .iter_mut() .enumerate() .map(|(idx, value)| (Idx::from_raw(RawIdx(idx as u32)), value)) } /// Reallocates the arena to make it take up as little space as possible. pub fn shrink_to_fit(&mut self) { self.data.shrink_to_fit(); } /// Returns the index of the next value allocated on the arena. /// /// This method should remain private to make creating invalid `Idx`s harder. fn next_idx(&self) -> Idx { Idx::from_raw(RawIdx(self.data.len() as u32)) } } impl Default for Arena { fn default() -> Arena { Arena { data: Vec::new() } } } impl Index> for Arena { type Output = T; fn index(&self, idx: Idx) -> &T { let idx = idx.into_raw().0 as usize; &self.data[idx] } } impl IndexMut> for Arena { fn index_mut(&mut self, idx: Idx) -> &mut T { let idx = idx.into_raw().0 as usize; &mut self.data[idx] } } impl Index> for Arena { type Output = [T]; fn index(&self, range: IdxRange) -> &[T] { let start = range.range.start as usize; let end = range.range.end as usize; &self.data[start..end] } } impl FromIterator for Arena { fn from_iter(iter: I) -> Self where I: IntoIterator, { Arena { data: Vec::from_iter(iter) } } }