Struct Allocator

pub struct Allocator<T: Clone> {
    pub connection_pool: Vec<Option<T>>,
    pub free_connections: VecDeque<usize>,
    pub allocated_connections: VecDeque<usize>,
}

An allocator for mapping an index to a value T.

Fields

• connection_pool - A vector of optional values of type T that can be allocated and deallocated, and accessed by index.
• free_connections - A queue of indices that have been deallocated and are available for allocation.
• allocated_connections - A queue of indices that have been allocated and are currently in use.

Fields

connection_pool: Vec<Option<T>>

free_connections: VecDeque<usize>

allocated_connections: VecDeque<usize>

Implementations

impl<T: Clone> Allocator<T>

pub fn new() -> Self

The constructor for the Allocator struct.

Returns

A new instance of the Allocator struct.

pub fn allocate(&mut self, connection: T) -> usize

Allocates a connection in the connection pool.

Arguments

• connection - The connection to be allocated.

Returns

The index of the allocated connection to be used to access the connection in the connection pool.

pub fn yield_next_allocated_index(&mut self) -> Option<usize>

Yields the next allocated index in the connection pool.

Returns

The next allocated index in the connection pool. (empty if thee is no allocated connection available)

pub fn extract_connection( &self, index: usize, ) -> Result<(T, usize), NanoServiceError>

Extracts a connection from the connection pool.

Arguments

• index - The index of the connection to be extracted.

Returns

The connection at the specified index.

pub fn deallocate(&mut self, index: usize) -> Result<T, NanoServiceError>

Deallocates a connection in the connection pool.

Arguments

• index - The index of the connection to be deallocated.

pub fn yield_connections(&self) -> Vec<T>

Yields all the connections in the connection pool.

Returns

A vector of all the connections in the connection pool.

Trait Implementations

impl<T: Debug + Clone> Debug for Allocator<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Clone> Default for Allocator<T>

fn default() -> Self

Returns the “default value” for a type.