Enum GrowthStrategy 

#[non_exhaustive]
pub enum GrowthStrategy {
    Exponential {
        numerator: usize,
        denominator: usize,
    },
    Linear {
        elements: usize,
    },
}

The strategy to employ when growing a vector.

Note that arithmetic overflow is not a concern for any of the strategies: if the final result of the calculation (in infinite precision) exceeds max_capacity, max_capacity is used as the new capacity.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Exponential

The current capacity is multiplied by numerator, then divided by denominator.

If the new capacity results in the last committed page having spare room for more elements, those elements are added to the new capacity.

Fields

numerator: usize

The number to multiply the current capacity by. Must be greater than denominator.

denominator: usize

The number to divide the multiplied number by. Must be nonzero.

Linear

elements is added to the current capacity.

If the new capacity results in the last committed page having spare room for more elements, those elements are added to the new capacity.

Fields

elements: usize

The number of elements to add to the current capacity. Must be nonzero.

Implementations

impl GrowthStrategy

pub const fn new() -> Self

Returns the default growth strategy: exponential growth with a growth factor of 2.

Trait Implementations

impl Clone for GrowthStrategy

fn clone(&self) -> GrowthStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GrowthStrategy

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

Formats the value using the given formatter.

impl Default for GrowthStrategy

fn default() -> Self

Returns the “default value” for a type.

impl Hash for GrowthStrategy

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for GrowthStrategy

fn eq(&self, other: &GrowthStrategy) -> 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 Copy for GrowthStrategy

impl Eq for GrowthStrategy

impl StructuralPartialEq for GrowthStrategy