Enum InvalidColumn 

pub enum InvalidColumn {
    NonDecreasingOffsets,
    TokenTooLarge,
    MissingPadding,
    CodeOutOfRange,
    BadRowOffsets,
    DecodedLenOverflow,
    EmptyToken,
    UnsortedTokens,
    IncompleteAlphabet,
}

A violation found while validating compressed buffers.

Two kinds. Safety violations would let an unchecked decoder read or write out of bounds — these are exactly the obligations an unsafe new_unchecked caller must uphold to avoid UB. Conformance violations, including a dictionary too large for the code address space, decode safely but make search / tokenize give wrong answers. The validate family checks both, so a trusted dictionary is fully conformant — indistinguishable from a trainer-built one.

Variants

NonDecreasingOffsets

Dictionary offsets decrease (offsets[i] > offsets[i + 1]), which would underflow the unchecked token-length subtraction.

TokenTooLarge

A dictionary token is longer than MAX_TOKEN_SIZE.

MissingPadding

A token offset has fewer than MAX_TOKEN_SIZE readable bytes after it, so the decoder’s fixed-width read runs off the end.

CodeOutOfRange

The dictionary has more than 2^16 entries, or a code does not index the dictionary (code >= num_tokens). In either case, the u16 token/code type cannot address the requested entry.

BadRowOffsets

Row offsets are not non-decreasing, or the last exceeds the code count.

DecodedLenOverflow

The column’s tokens sum to more than usize::MAX decoded bytes, so the decoded-length computation overflows and would under-size the output buffer.

EmptyToken

A dictionary token has zero length (offsets not strictly increasing).

UnsortedTokens

Dictionary tokens are not in strictly ascending bytewise order, so they are not sorted (binary search breaks) or not unique.

IncompleteAlphabet

The dictionary lacks one or more of the 256 single-byte tokens, so some inputs are not encodable.

Trait Implementations

impl Clone for InvalidColumn

fn clone(&self) -> InvalidColumn

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for InvalidColumn

impl Debug for InvalidColumn

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

Formats the value using the given formatter.

impl Display for InvalidColumn

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

Formats the value using the given formatter.

impl Eq for InvalidColumn

impl Error for InvalidColumn

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 PartialEq for InvalidColumn

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for InvalidColumn