Enum Start 

#[non_exhaustive]
pub enum Start {
    Oldest,
    Latest,
}

Where a decoder starts on a track that already holds groups.

A track keeps its groups for a while after they are read, so a decoder does not always open on an empty one: a player rebuilding its decoder subscribes while its predecessor still holds groups, and a rendition switched away from and back to stays warm for the track’s idle linger. What to do with that backlog depends on the consumer, and the two answers are opposites, so it is asked rather than guessed.

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.

Oldest

The oldest group the track still holds, decoding everything cached.

What a recorder, an export, or anything reading a complete track wants, and the default because dropping media a caller has not asked to drop is the worse mistake.

Latest

The newest group, skipping whatever is already cached.

What a live player wants. Without it a rebuilt decoder walks the whole backlog at decode speed before reaching live media, which a viewer sees as playback jumping backwards and then sprinting to catch up.

Trait Implementations

impl Clone for Start

fn clone(&self) -> Start

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Start

impl Debug for Start

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

Formats the value using the given formatter.

impl Default for Start

fn default() -> Start

Returns the “default value” for a type.

impl Eq for Start

impl PartialEq for Start

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Start