pipecircuit 0.0.18

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
29
30
31
32
33
34

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

use super::super::dense_key_index::{DenseKeyIndex, DenseKeyIndexCreationError};
use super::{IndexKey, UniqueIndex};

#[derive(Debug)]
pub enum UniqueIndexCreationError {
    CapacityOverflow { maximum_keys: usize },
    KeyStorageUnavailable { source: TryReserveError },
    IndexStorageUnavailable { source: TryReserveError },
}

impl<Key: IndexKey> UniqueIndex<Key> {
    pub fn try_new(maximum_keys: usize) -> Result<Self, UniqueIndexCreationError> {
        let key_index = DenseKeyIndex::try_new(maximum_keys).map_err(|reason| match reason {
            DenseKeyIndexCreationError::CapacityOverflow { maximum_rows } => {
                UniqueIndexCreationError::CapacityOverflow {
                    maximum_keys: maximum_rows,
                }
            }
            DenseKeyIndexCreationError::StorageUnavailable { source } => {
                UniqueIndexCreationError::IndexStorageUnavailable { source }
            }
        })?;
        let mut keys = Vec::new();
        keys.try_reserve_exact(maximum_keys)
            .map_err(|source| UniqueIndexCreationError::KeyStorageUnavailable { source })?;
        Ok(Self {
            maximum_keys,
            keys,
            key_index,
        })
    }
}