Enum tantivy_fst::raw::Error

pub enum Error {
    Version {
        expected: u64,
        got: u64,
    },
    Format,
    DuplicateKey {
        got: Vec<u8>,
    },
    OutOfOrder {
        previous: Vec<u8>,
        got: Vec<u8>,
    },
    WrongType {
        expected: FstType,
        got: FstType,
    },
    FromUtf8(FromUtf8Error),
}

An error that occurred while using a finite state transducer.

Variants

Version

A version mismatch occurred while reading a finite state transducer.

This occurs when the API version (of the crate) does not match the version encoded in the finite state transducer.

When this error is encountered, there are only two ways to fix it:

1. Change the version of the library to one that is compatible with the given finite state transducer.
2. Rebuild the finite state transducer.

Fields of Version

expected: u64

The expected version, which is hard-coded into the current version of this crate.

got: u64

The version read from the finite state transducer.

Format

An unexpected error occurred while reading a finite state transducer. Usually this occurs because the data is corrupted or is not actually a finite state transducer serialized by this library.

DuplicateKey

A duplicate key was inserted into a finite state transducer, which is not allowed.

Fields of DuplicateKey

got: Vec<u8>

The duplicate key.

OutOfOrder

A key was inserted out of order into a finite state transducer.

Keys must always be inserted in lexicographic order.

Fields of OutOfOrder

previous: Vec<u8>

The last key successfully inserted.

got: Vec<u8>

The key that caused this error to occur.

WrongType

A finite state transducer with an unexpected type was found.

This is not currently used in this crate, but callers may wish to employ its use for alternative data structures implemented on top of finite state transducers.

Fields of WrongType

expected: FstType

The expected finite state transducer type.

got: FstType

The type read from a finite state transducer.

FromUtf8(FromUtf8Error)

An error that occurred when trying to decode a UTF-8 byte key.

Trait Implementations

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, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Error for Error

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

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

Deprecated since 1.42.0:

use the Display impl or to_string()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

impl From<Error> for Error

fn from(err: Error) -> Error

Performs the conversion.

impl From<FromUtf8Error> for Error

fn from(err: FromUtf8Error) -> Self

Performs the conversion.