Struct regex_automata::hybrid::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.

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

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 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()

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

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting