Struct SectionSetCollector 

pub struct SectionSetCollector { /* private fields */ }

Generic collector for long-form section_number/last_section_number sequences.

The constructor SectionSetCollector::new uses the default cap DEFAULT_MAX_PARTIAL_KEYS; the cap is configurable via with_max_partial_keys.

Implementations

impl SectionSetCollector

pub fn new() -> Self

Create an empty collector with the default cap (DEFAULT_MAX_PARTIAL_KEYS).

pub fn with_max_partial_keys(self, max_partial_keys: usize) -> Self

Replace the partial-key cap (default DEFAULT_MAX_PARTIAL_KEYS). Sections for new keys are skipped when the map is full, until clear frees capacity.

pub fn push_section( &mut self, bytes: impl AsRef<[u8]>, ) -> CollectResult<Option<CompleteSectionSet>>

Push one complete section. Returns Some only when the logical section set has become complete for the first time at this version.

Errors

Returns a CollectError if the bytes are not a valid long-form section or if the section set becomes internally inconsistent. Treat the error as applying to this section only unless your application wants strict stream-fail behavior.

pub fn push_section_with_pid( &mut self, pid: Option<u16>, bytes: impl AsRef<[u8]>, ) -> CollectResult<Option<CompleteSectionSet>>

Push one complete section with PID context.

The PID is folded into the section-set key so tables with identical table id/extension on different PIDs do not collide.

pub fn clear(&mut self)

Drop all retained partial section sets.

pub fn len(&self) -> usize

Number of retained partial section-set states.

pub fn is_empty(&self) -> bool

Whether the collector currently has no retained state.

Trait Implementations

impl Debug for SectionSetCollector

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

Formats the value using the given formatter.

impl Default for SectionSetCollector

fn default() -> Self

Returns the “default value” for a type.