//! A key-value map that can also model array-like structures. use std::collections::BTreeMap; use std::fmt::{self, Debug, Display, Formatter}; use std::ops::Index; use crate::syntax::span::{Span, Spanned}; /// A table data structure, which maps from integers (`u64`) or strings to a /// generic value type. /// /// The table can be used to model arrays by assigns values to successive /// indices from `0..n`. The table type offers special support for this pattern /// through the `push` method. #[derive(Clone)] pub struct Table { nums: BTreeMap, strs: BTreeMap, lowest_free: u64, } impl Table { /// Create a new empty table. pub fn new() -> Self { Self { nums: BTreeMap::new(), strs: BTreeMap::new(), lowest_free: 0, } } /// The total number of entries in the table. pub fn len(&self) -> usize { self.nums.len() + self.strs.len() } /// Whether the table contains no entries. pub fn is_empty(&self) -> bool { self.len() == 0 } /// The first number key-value pair (with lowest number). pub fn first(&self) -> Option<(u64, &V)> { self.nums.iter().next().map(|(&k, v)| (k, v)) } /// The last number key-value pair (with highest number). pub fn last(&self) -> Option<(u64, &V)> { self.nums.iter().next_back().map(|(&k, v)| (k, v)) } /// Get a reference to the value with the given key. pub fn get<'a, K>(&self, key: K) -> Option<&V> where K: Into>, { match key.into() { BorrowedKey::Num(num) => self.nums.get(&num), BorrowedKey::Str(string) => self.strs.get(string), } } /// Borrow the value with the given key mutably. pub fn get_mut<'a, K>(&mut self, key: K) -> Option<&mut V> where K: Into>, { match key.into() { BorrowedKey::Num(num) => self.nums.get_mut(&num), BorrowedKey::Str(string) => self.strs.get_mut(string), } } /// Insert a value into the table. pub fn insert(&mut self, key: K, value: V) where K: Into, { match key.into() { OwnedKey::Num(num) => { self.nums.insert(num, value); if self.lowest_free == num { self.lowest_free += 1; } } OwnedKey::Str(string) => { self.strs.insert(string, value); } } } /// Remove the value with the given key from the table. pub fn remove<'a, K>(&mut self, key: K) -> Option where K: Into>, { match key.into() { BorrowedKey::Num(num) => { self.lowest_free = self.lowest_free.min(num); self.nums.remove(&num) } BorrowedKey::Str(string) => self.strs.remove(string), } } /// Append a value to the table. /// /// This will associate the `value` with the lowest free number key (zero if /// there is no number key so far). pub fn push(&mut self, value: V) { while self.nums.contains_key(&self.lowest_free) { self.lowest_free += 1; } self.nums.insert(self.lowest_free, value); self.lowest_free += 1; } /// Iterator over all borrowed keys and values. pub fn iter(&self) -> impl Iterator { self.nums().map(|(&k, v)| (BorrowedKey::Num(k), v)) .chain(self.strs().map(|(k, v)| (BorrowedKey::Str(k), v))) } /// Iterate over all values in the table. pub fn values(&self) -> impl Iterator { self.nums().map(|(_, v)| v).chain(self.strs().map(|(_, v)| v)) } /// Iterate over the number key-value pairs. pub fn nums(&self) -> std::collections::btree_map::Iter { self.nums.iter() } /// Iterate over the string key-value pairs. pub fn strs(&self) -> std::collections::btree_map::Iter { self.strs.iter() } /// Move into an owned iterator over owned keys and values. pub fn into_iter(self) -> impl Iterator { self.nums.into_iter().map(|(k, v)| (OwnedKey::Num(k), v)) .chain(self.strs.into_iter().map(|(k, v)| (OwnedKey::Str(k), v))) } /// Move into an owned iterator over all values in the table. pub fn into_values(self) -> impl Iterator { self.nums.into_iter().map(|(_, v)| v) .chain(self.strs.into_iter().map(|(_, v)| v)) } /// Iterate over the number key-value pairs. pub fn into_nums(self) -> std::collections::btree_map::IntoIter { self.nums.into_iter() } /// Iterate over the string key-value pairs. pub fn into_strs(self) -> std::collections::btree_map::IntoIter { self.strs.into_iter() } } impl<'a, K, V> Index for Table where K: Into>, { type Output = V; fn index(&self, index: K) -> &Self::Output { self.get(index).expect("key not in table") } } impl Default for Table { fn default() -> Self { Self::new() } } impl Eq for Table {} impl PartialEq for Table { fn eq(&self, other: &Self) -> bool { self.iter().eq(other.iter()) } } impl Debug for Table { fn fmt(&self, f: &mut Formatter) -> fmt::Result { if self.is_empty() { return f.write_str("()"); } let mut builder = f.debug_tuple(""); struct Entry<'a>(bool, &'a dyn Display, &'a dyn Debug); impl<'a> Debug for Entry<'a> { fn fmt(&self, f: &mut Formatter) -> fmt::Result { if self.0 { f.write_str("\"")?; } self.1.fmt(f)?; if self.0 { f.write_str("\"")?; } if f.alternate() { f.write_str(" = ")?; } else { f.write_str("=")?; } self.2.fmt(f) } } for (key, value) in self.nums() { builder.field(&Entry(false, &key, &value)); } for (key, value) in self.strs() { builder.field(&Entry(key.contains(' '), &key, &value)); } builder.finish() } } /// The owned variant of a table key. #[derive(Debug, Clone, Eq, PartialEq, Ord, PartialOrd)] pub enum OwnedKey { Num(u64), Str(String), } impl From> for OwnedKey { fn from(key: BorrowedKey<'_>) -> Self { match key { BorrowedKey::Num(num) => Self::Num(num), BorrowedKey::Str(string) => Self::Str(string.to_string()), } } } impl From for OwnedKey { fn from(num: u64) -> Self { Self::Num(num) } } impl From for OwnedKey { fn from(string: String) -> Self { Self::Str(string) } } impl From<&'static str> for OwnedKey { fn from(string: &'static str) -> Self { Self::Str(string.to_string()) } } /// The borrowed variant of a table key. #[derive(Debug, Copy, Clone, Eq, PartialEq, Ord, PartialOrd)] pub enum BorrowedKey<'a> { Num(u64), Str(&'a str), } impl From for BorrowedKey<'static> { fn from(num: u64) -> Self { Self::Num(num) } } impl<'a> From<&'a String> for BorrowedKey<'a> { fn from(string: &'a String) -> Self { Self::Str(&string) } } impl<'a> From<&'a str> for BorrowedKey<'a> { fn from(string: &'a str) -> Self { Self::Str(string) } } /// An table entry which tracks key and value span. #[derive(Clone, PartialEq)] pub struct SpannedEntry { pub key: Span, pub val: Spanned, } impl SpannedEntry { /// Create a new entry. pub fn new(key: Span, val: Spanned) -> Self { Self { key, val } } /// Create an entry with the same span for key and value. pub fn val(val: Spanned) -> Self { Self { key: val.span, val } } /// Convert from `&SpannedEntry` to `SpannedEntry<&T>` pub fn as_ref(&self) -> SpannedEntry<&V> { SpannedEntry { key: self.key, val: self.val.as_ref() } } /// Map the entry to a different value type. pub fn map(self, f: impl FnOnce(V) -> U) -> SpannedEntry { SpannedEntry { key: self.key, val: self.val.map(f) } } } impl Debug for SpannedEntry { fn fmt(&self, f: &mut Formatter) -> fmt::Result { if f.alternate() { f.write_str("key")?; self.key.fmt(f)?; f.write_str(" ")?; } self.val.fmt(f) } } #[cfg(test)] mod tests { use super::Table; #[test] fn test_table_different_key_types_dont_interfere() { let mut table = Table::new(); table.insert(10, "hello"); table.insert("twenty", "there"); assert_eq!(table.len(), 2); assert_eq!(table[10], "hello"); assert_eq!(table["twenty"], "there"); } #[test] fn test_table_push_skips_already_inserted_keys() { let mut table = Table::new(); table.insert(2, "2"); table.push("0"); table.insert(3, "3"); table.push("1"); table.push("4"); assert_eq!(table.len(), 5); assert_eq!(table[0], "0"); assert_eq!(table[1], "1"); assert_eq!(table[2], "2"); assert_eq!(table[3], "3"); assert_eq!(table[4], "4"); } #[test] fn test_table_push_remove_push_reuses_index() { let mut table = Table::new(); table.push("0"); table.push("1"); table.push("2"); table.remove(1); table.push("a"); table.push("3"); assert_eq!(table.len(), 4); assert_eq!(table[0], "0"); assert_eq!(table[1], "a"); assert_eq!(table[2], "2"); assert_eq!(table[3], "3"); } #[test] fn test_table_first_and_last_are_correct() { let mut table = Table::new(); assert_eq!(table.first(), None); assert_eq!(table.last(), None); table.insert(4, "hi"); table.insert("string", "hi"); assert_eq!(table.first(), Some((4, &"hi"))); assert_eq!(table.last(), Some((4, &"hi"))); table.insert(2, "bye"); assert_eq!(table.first(), Some((2, &"bye"))); assert_eq!(table.last(), Some((4, &"hi"))); } #[test] fn test_table_format_debug() { let mut table = Table::new(); assert_eq!(format!("{:?}", table), "()"); assert_eq!(format!("{:#?}", table), "()"); table.insert(10, "hello"); table.insert("twenty", "there"); table.insert("sp ace", "quotes"); assert_eq!( format!("{:?}", table), r#"(10="hello", "sp ace"="quotes", twenty="there")"#, ); assert_eq!(format!("{:#?}", table).lines().collect::>(), [ "(", r#" 10 = "hello","#, r#" "sp ace" = "quotes","#, r#" twenty = "there","#, ")", ]); } }