Enum constriction::stream::queue::DecoderFrontendError

#[non_exhaustive]
pub enum DecoderFrontendError {
    InvalidData,
}

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.

InvalidData

This can only happen if both of the following conditions apply:

1. we are decoding invalid compressed data; and
2. we use entropy models with varying PRECISIONs.

Unless you change the PRECISION mid-decoding this error cannot occur. However, note that the encoder is not surjective, i.e., it cannot reach all possible values. The reason why the decoder still doesn’t err (unless varying PRECISIONs are used) is that it is not injective, i.e., it maps the bit strings that are unreachable by the encoder to symbols that could have been encoded into a different bit string.

The lack of injectivity of the encoder makes the Range Coder implementation in this library unsuitable for bitsback coding. Even though you can encode an arbitrary bit string into a sequence of symbols using any entropy model, decoding the sequence of symbols with the same entropy models won’t always give you the same bit string. In other words,

• range_decode(range_encode(sequence_of_symbols)) = sequence_of_symbols for all sequence_of_symbols; but
• range_encode(range_encode(bit_string)) != bit_string in general.

If you need equality in the second relation, use an AnsCoder.

Trait Implementations

impl Debug for DecoderFrontendError

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

Formats the value using the given formatter.

impl Display for DecoderFrontendError

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

Formats the value using the given formatter.

impl Error for DecoderFrontendError

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

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.