Enum Error 

#[non_exhaustive]
pub enum Error {
    BufferTooShort(BufferTooShort),
    OutputBufferTooSmall(OutputBufferTooSmall),
    BadDataIdentifier(u8),
    InvalidSync(InvalidSync),
    BadEndOfPesMarker(u8),
    UnknownSegmentType(u8),
    BadStuffingByte(u8),
    SegmentTooLarge,
    FieldOverflow(FieldOverflow),
    InvalidSubregionCount(usize),
    SubregionPositionMismatch,
    TrailingEntryBytes {
        what: &'static str,
        entry_len: usize,
        extra: usize,
    },
    InvalidValue(InvalidValue),
}

A DVB subtitle parse or serialize error.

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.

BufferTooShort(BufferTooShort)

Input shorter than required.

OutputBufferTooSmall(OutputBufferTooSmall)

Output buffer smaller than the serialized form requires.

BadDataIdentifier(u8)

The data_identifier was not the required 0x20.

InvalidSync(InvalidSync)

A fixed marker did not match (sync_byte, expected 0x0F).

BadEndOfPesMarker(u8)

The end_of_PES_data_field_marker was not 0xFF.

UnknownSegmentType(u8)

An unrecognised or invalid segment_type was encountered.

BadStuffingByte(u8)

Stuffing byte was not 0x00.

SegmentTooLarge

Segment length too large for parsed data.

FieldOverflow(FieldOverflow)

A field value did not fit its wire width (#1129/#1044): compared before narrowing, so an over-range value is rejected instead of silently masked/wrapped.

InvalidSubregionCount(usize)

A DisparityRegion had 0 or more than 4 subregions — the wire number_of_subregions_minus_1 field (Table 29) is 2 bits, so only 1..=4 subregions are representable.

SubregionPositionMismatch

A Subregion’s subregion_horizontal_position/subregion_width presence didn’t match the region’s subregion count (Table 29: both are present for every subregion when, and only when, the region has more than one).

TrailingEntryBytes

A repeating-entry loop (Table 31’s CLUT entry loop; Table 21’s page composition region loop) had leftover bytes that don’t form a whole entry, where the spec’s own loop condition never leaves a remainder.

Fields

what: &'static str

What loop this was (e.g. "alternative_CLUT_segment entries").

entry_len: usize

The fixed size of one entry.

extra: usize

How many bytes were left over.

InvalidValue(InvalidValue)

A field value does not fit the bits the wire format gives it (e.g. a reduced-range CLUT colour component wider than its 6/4/2-bit slot).

Trait Implementations

impl Clone for Error

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<BufferTooShort> for Error

fn from(source: BufferTooShort) -> Self

Converts to this type from the input type.

impl From<FieldOverflow> for Error

fn from(source: FieldOverflow) -> Self

Converts to this type from the input type.

impl From<InvalidSync> for Error

fn from(source: InvalidSync) -> Self

Converts to this type from the input type.

impl From<InvalidValue> for Error

fn from(source: InvalidValue) -> Self

Converts to this type from the input type.

impl From<OutputBufferTooSmall> for Error

fn from(source: OutputBufferTooSmall) -> Self

Converts to this type from the input type.

impl PartialEq for Error

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Error