pawkit-holy-array 0.1.13

A small library implemnenting a freelist
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

use std::{iter::FilterMap, slice::Iter};

/// An array that allows holes in data, and automatically manages free slots
#[derive(Debug)]
pub struct HolyArray<T> {
    data: Vec<Option<T>>,
    free_slots: Vec<usize>,
}

impl<T> HolyArray<T> {
    pub fn new() -> Self {
        return Self {
            data: vec![],
            free_slots: vec![],
        };
    }

    pub fn acquire(&mut self, value: T) -> usize {
        let Some(idx) = self.free_slots.pop() else {
            let idx = self.data.len();
            self.data.push(Some(value));
            return idx;
        };

        self.data[idx] = Some(value);

        return idx;
    }

    pub fn release(&mut self, index: usize) {
        if index >= self.data.len() {
            return;
        }

        if self.data[index].is_none() {
            return;
        }

        self.data[index] = None;
        self.free_slots.push(index);
    }

    pub fn get(&self, index: usize) -> Option<&T> {
        let Some(Some(value)) = self.data.get(index) else {
            return None;
        };

        return Some(value);
    }

    pub fn get_mut(&mut self, index: usize) -> Option<&mut T> {
        let Some(Some(value)) = self.data.get_mut(index) else {
            return None;
        };

        return Some(value);
    }

    pub fn len(&self) -> usize {
        return self.data.len();
    }
}

impl<'a, T> IntoIterator for &'a HolyArray<T> {
    type Item = &'a T;
    type IntoIter = FilterMap<Iter<'a, Option<T>>, fn(&'a Option<T>) -> Option<&'a T>>;

    fn into_iter(self) -> Self::IntoIter {
        self.data.iter().filter_map(|item| item.as_ref())
    }
}