Enum CapacityExhaustedBehavior 

pub enum CapacityExhaustedBehavior {
    Silent,
    Error,
    Panic,
}

What happens when the filter reaches MAX_FILTERS and cannot grow further.

Capacity exhaustion is a structural limit, not a transient error: once MAX_FILTERS sub-filters exist, no new ones can be added regardless of fill rate. Insertions that would require a new filter instead go into the last sub-filter, increasing its FPR beyond the configured target.

Variants

Silent

Continue inserting into the saturated last filter.

The FPR degrades silently but no error is returned. Appropriate for workloads where data loss is worse than a degraded FPR.

Error

Return Err(BloomCraftError::MaxFiltersExceeded) from insert_checked.

insert (the infallible variant) ignores this setting and behaves as Silent. Use insert_checked consistently if you want error propagation.

Panic

Available on debug-assertions enabled only.

Panic immediately.

Only available in debug builds. Use in tests to surface capacity exhaustion as a hard failure rather than a silently degraded filter.

Trait Implementations

impl Clone for CapacityExhaustedBehavior

fn clone(&self) -> CapacityExhaustedBehavior

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for CapacityExhaustedBehavior

impl Debug for CapacityExhaustedBehavior

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

Formats the value using the given formatter.

impl Default for CapacityExhaustedBehavior

fn default() -> CapacityExhaustedBehavior

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CapacityExhaustedBehavior

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CapacityExhaustedBehavior

impl PartialEq for CapacityExhaustedBehavior

fn eq(&self, other: &CapacityExhaustedBehavior) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CapacityExhaustedBehavior

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CapacityExhaustedBehavior