pipecircuit 0.0.23

Correct. Robust. Fast. Portable. Pick four.
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

use alloc::{collections::TryReserveError, vec::Vec};

use super::{DenseKeyIndex, EMPTY_ROW};

const MINIMUM_BUCKETS: usize = 8;

pub(in crate::storage::warp_table) enum DenseKeyIndexCreationError {
    CapacityOverflow { maximum_rows: usize },
    StorageUnavailable { source: TryReserveError },
}

impl DenseKeyIndex {
    pub(in crate::storage::warp_table) fn try_new(
        maximum_rows: usize,
    ) -> Result<Self, DenseKeyIndexCreationError> {
        let bucket_count = maximum_rows
            .checked_mul(2)
            .map(|count| count.max(MINIMUM_BUCKETS))
            .and_then(usize::checked_next_power_of_two)
            .ok_or(DenseKeyIndexCreationError::CapacityOverflow { maximum_rows })?;
        let mut buckets = Vec::new();
        buckets
            .try_reserve_exact(bucket_count)
            .map_err(|source| DenseKeyIndexCreationError::StorageUnavailable { source })?;
        buckets.resize(bucket_count, EMPTY_ROW);
        Ok(Self { buckets })
    }
}