Struct regex_automata::hybrid::error::CacheError

pub struct CacheError(());

An error that occurs when cache usage has become inefficient.

One of the weaknesses of a lazy DFA is that it may need to clear its cache repeatedly if it’s not big enough. If this happens too much, then it can slow searching down significantly. A mitigation to this is to use heuristics to detect whether the cache is being used efficiently or not. If not, then a lazy DFA can return a CacheError.

The default configuration of a lazy DFA in this crate is set such that a CacheError will never occur. Instead, callers must opt into this behavior with settings like dfa::Config::minimum_cache_clear_count and dfa::Config::minimum_bytes_per_state.

When the std feature is enabled, this implements the std::error::Error trait.

Tuple Fields

0: ()

Implementations

impl CacheError

pub(crate) fn too_many_cache_clears() -> CacheError

pub(crate) fn bad_efficiency() -> CacheError

Trait Implementations

impl Clone for CacheError

fn clone(&self) -> CacheError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CacheError

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

Formats the value using the given formatter.

impl Display for CacheError

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

Formats the value using the given formatter.

impl Error for CacheError

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.