Struct ParamList 

pub struct ParamList { /* private fields */ }

Fixed-capacity, inline parameter storage for the parser hot path.

Sequences may be split across feed_with calls, so parameters cannot be borrowed from the input and must be buffered by the parser. This type does so with a bounded, inline arena so that parsing is allocation-free (and memcpy-only) for all input:

• at most MAX_PARAMS parameters per sequence;
• at most MAX_PARAM_LEN bytes per parameter;
• at most MAX_PARAM_BYTES parameter bytes in total per sequence.

Implementations

impl ParamList

pub const EMPTY: Self

An empty list. const-callable and usable in statics.

pub fn len(&self) -> usize

The number of collected parameters.

pub fn is_empty(&self) -> bool

Whether no parameters have been collected.

pub fn iter(&self) -> ParamListIter<'_>

The collected parameters, as byte slices.

pub fn overflowed(&self) -> bool

Whether any parameter bytes were dropped: bytes past a parameter’s MAX_PARAM_LEN cap, or parameters past the MAX_PARAMS / MAX_PARAM_BYTES sequence caps.

pub fn get(&self, index: usize) -> Option<&[u8]>

The parameter at index, if any.

pub fn byte_len(&self) -> usize

The number of parameter bytes (excluding ; separators).

pub fn push_param(&mut self, param: &[u8])

Append a parameter, clamping on overflow (see the type docs).

Bytes beyond MAX_PARAM_LEN within the current parameter, and any parameter that does not fit the remaining sequence capacity, are dropped; parsing continues normally. Sets overflowed if anything was dropped.

pub fn clear(&mut self)

Drop all collected parameters.

Trait Implementations

impl Clone for ParamList

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ParamList

impl Debug for ParamList

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

Formats the value using the given formatter.

impl Default for ParamList

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ParamList

impl Hash for ParamList

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 ParamList

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

Equality operator ==.

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

Inequality operator !=.