feanor-math 3.5.18

A library for number theory, providing implementations for arithmetic in various rings and algorithms working on them.
Documentation
use std::sync::OnceLock;

use append_only_vec::AppendOnlyVec;

/// Vector whose elements are never modified but added.
/// More general than [`AppendOnlyVec`] in that we can control
/// at what index an element is inserted, if not present.
pub struct LazyVec<T> {
    data: AppendOnlyVec<OnceLock<T>>,
}

impl<T> LazyVec<T> {
    pub fn new() -> Self {
        Self {
            data: AppendOnlyVec::new(),
        }
    }

    #[allow(unused)]
    pub fn get(&self, i: usize) -> Option<&T> { self.data[i].get() }

    #[allow(unused)]
    pub fn get_or_init_incremental<F>(&self, target_index: usize, mut derive_next: F) -> &T
    where
        F: FnMut(usize, &T) -> T,
    {
        while self.data.len() <= target_index {
            _ = self.data.push(OnceLock::new());
        }
        for i in (0..=target_index).rev() {
            if let Some(mut value) = self.data[i].get() {
                for j in (i + 1)..=target_index {
                    value = self.data[j].get_or_init(|| derive_next(j, value));
                }
                return self.data[target_index].get().unwrap();
            }
        }
        panic!("get_or_init_incremental() is only valid when the vector has at least one initialized element")
    }

    pub fn get_or_init<F>(&self, i: usize, init: F) -> &T
    where
        F: FnOnce() -> T,
    {
        while self.data.len() <= i {
            _ = self.data.push(OnceLock::new());
        }
        return self.data[i].get_or_init(init);
    }
}

impl<T> Clone for LazyVec<T>
where
    T: Clone,
{
    fn clone(&self) -> Self {
        Self {
            data: self
                .data
                .iter()
                .map(|data| {
                    if let Some(value) = data.get() {
                        let result = OnceLock::new();
                        _ = result.set(value.clone());
                        result
                    } else {
                        OnceLock::new()
                    }
                })
                .collect(),
        }
    }
}