Enum AdaptiveCodes 

pub enum AdaptiveCodes {
    U8(Vec<u8>),
    U16(Vec<u16>),
    U32(Vec<u32>),
    U64(Vec<u64>),
}

Adaptive-width code storage. Promotes to a wider arm only when the current arm physically cannot hold the next code:

• U8 → U16 when inserting a code ≥ 256
• U16 → U32 when inserting a code ≥ 65 536
• U32 → U64 when inserting a code ≥ 2³²

Promotion preserves all existing codes bit-for-bit. The len() and the sequence of values returned by iter() are invariant under promotion.

Variants

U8(Vec<u8>)

U16(Vec<u16>)

U32(Vec<u32>)

U64(Vec<u64>)

Implementations

impl AdaptiveCodes

pub fn new() -> Self

Empty U8-arm storage.

pub fn with_capacity(cap: usize) -> Self

Pre-allocated empty U8-arm storage.

pub fn len(&self) -> usize

Number of codes stored.

pub fn is_empty(&self) -> bool

True if no codes stored.

pub fn push(&mut self, code: u64)

Append a code. Promotes the arm in-place if code does not fit.

Promotion is lazy: a U8 arm with codes [0, 1, 2] and an insert of 255 stays U8; insert of 256 promotes to U16 with codes [0, 1, 2, 256].

pub fn get(&self, i: usize) -> u64

Get the code at index i. Panics if i >= len().

pub fn iter(&self) -> Box<dyn Iterator<Item = u64> + '_>

Iterate codes as u64 (the widest representation, lossless for all arms).

pub fn width_bytes(&self) -> usize

Width in bytes per code (1, 2, 4, or 8). Useful for memory accounting and benchmarks.

Trait Implementations

impl Clone for AdaptiveCodes

fn clone(&self) -> AdaptiveCodes

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AdaptiveCodes

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

Formats the value using the given formatter.

impl Default for AdaptiveCodes

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for AdaptiveCodes

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

impl StructuralPartialEq for AdaptiveCodes