Struct fancy_regex::RegexBuilder
source · pub struct RegexBuilder(_);
Expand description
A builder for a Regex
to allow configuring options.
Implementations§
source§impl RegexBuilder
impl RegexBuilder
sourcepub fn new(pattern: &str) -> Self
pub fn new(pattern: &str) -> Self
Create a new regex builder with a regex pattern.
If the pattern is invalid, the call to build
will fail later.
sourcepub fn build(&self) -> Result<Regex>
pub fn build(&self) -> Result<Regex>
Build the Regex
.
Returns an Error
if the pattern could not be parsed.
sourcepub fn backtrack_limit(&mut self, limit: usize) -> &mut Self
pub fn backtrack_limit(&mut self, limit: usize) -> &mut Self
Limit for how many times backtracking should be attempted for fancy regexes (where
backtracking is used). If this limit is exceeded, execution returns an error with
Error::BacktrackLimitExceeded
.
This is for preventing a regex with catastrophic backtracking to run for too long.
Default is 1_000_000
(1 million).
sourcepub fn delegate_size_limit(&mut self, limit: usize) -> &mut Self
pub fn delegate_size_limit(&mut self, limit: usize) -> &mut Self
Set the approximate size limit of the compiled regular expression.
This option is forwarded from the wrapped regex
crate. Note that depending on the used
regex features there may be multiple delegated sub-regexes fed to the regex
crate. As
such the actual limit is closer to <number of delegated regexes> * delegate_size_limit
.
sourcepub fn delegate_dfa_size_limit(&mut self, limit: usize) -> &mut Self
pub fn delegate_dfa_size_limit(&mut self, limit: usize) -> &mut Self
Set the approximate size of the cache used by the DFA.
This option is forwarded from the wrapped regex
crate. Note that depending on the used
regex features there may be multiple delegated sub-regexes fed to the regex
crate. As
such the actual limit is closer to <number of delegated regexes> * delegate_dfa_size_limit
.