Enum InitializationStrategy 

pub enum InitializationStrategy<T> {
    Lazy,
    Eager {
        initializer: Box<dyn Fn() -> T + Send + Sync>,
    },
    Custom {
        initializer: Box<dyn Fn() -> T + Send + Sync>,
        reset: Option<Box<dyn Fn(&mut T) + Send + Sync>>,
    },
}

Strategy for initializing objects in a memory pool.

Examples

use fastalloc::InitializationStrategy;

// Lazy initialization (default)
let strategy = InitializationStrategy::<i32>::Lazy;

// Eager initialization with a default value
let strategy = InitializationStrategy::Eager {
    initializer: Box::new(|| 42),
};

// Custom initialization with reset callback
let strategy = InitializationStrategy::Custom {
    initializer: Box::new(|| vec![1, 2, 3]),
    reset: Some(Box::new(|v| v.clear())),
};

Variants

Lazy

Initialize objects only when first allocated (lazy).

Eager

Initialize all objects eagerly when pool is created.

Fields

initializer: Box<dyn Fn() -> T + Send + Sync>

Function to create initial values

Custom

Custom initialization with optional reset function.

Fields

initializer: Box<dyn Fn() -> T + Send + Sync>

Function to create initial values

reset: Option<Box<dyn Fn(&mut T) + Send + Sync>>

Optional function to reset objects when returned to pool

Implementations

impl<T> InitializationStrategy<T>

pub fn eager(initializer: impl Fn() -> T + Send + Sync + 'static) -> Self

Creates an eager initialization strategy with the given initializer.

pub fn custom( initializer: impl Fn() -> T + Send + Sync + 'static, reset: impl Fn(&mut T) + Send + Sync + 'static, ) -> Self

Creates a custom initialization strategy with both initializer and reset function.

pub fn custom_init_only( initializer: impl Fn() -> T + Send + Sync + 'static, ) -> Self

Creates a custom initialization strategy with only an initializer.

pub fn is_lazy(&self) -> bool

Returns whether this strategy is lazy.

pub fn is_eager(&self) -> bool

Returns whether this strategy is eager.

pub fn initialize(&self) -> Option<T>

Creates an initial value if an initializer is available.

pub fn reset(&self, value: &mut T)

Resets an object using the reset function, if available.

Trait Implementations

impl<T> Debug for InitializationStrategy<T>

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

Formats the value using the given formatter.

impl<T> Default for InitializationStrategy<T>

fn default() -> Self

Returns the “default value” for a type.