Struct regex_cache::LazyRegexBuilder
[−]
[src]
pub struct LazyRegexBuilder { /* fields omitted */ }
A configurable builder for a lazy Regex
.
Methods
impl LazyRegexBuilder
[src]
fn new(source: &str) -> LazyRegexBuilder
Create a new regular expression builder with the given pattern.
If the pattern is invalid, then an error will be returned when
compile
is called.
fn build(&self) -> Result<LazyRegex, Error>
Consume the builder and compile the regular expression.
Note that calling as_str
on the resulting Regex
will produce the
pattern given to new
verbatim. Notably, it will not incorporate any
of the flags set on this builder.
fn case_insensitive(&mut self, yes: bool) -> &mut LazyRegexBuilder
Set the value for the case insensitive (i
) flag.
fn multi_line(&mut self, yes: bool) -> &mut LazyRegexBuilder
Set the value for the multi-line matching (m
) flag.
fn dot_matches_new_line(&mut self, yes: bool) -> &mut LazyRegexBuilder
Set the value for the any character (s
) flag, where in .
matches
anything when s
is set and matches anything except for new line when
it is not set (the default).
N.B. "matches anything" means "any byte" for regex::bytes::Regex
expressions and means "any Unicode scalar value" for regex::Regex
expressions.
fn swap_greed(&mut self, yes: bool) -> &mut LazyRegexBuilder
Set the value for the greedy swap (U
) flag.
fn ignore_whitespace(&mut self, yes: bool) -> &mut LazyRegexBuilder
Set the value for the ignore whitespace (x
) flag.
fn unicode(&mut self, yes: bool) -> &mut LazyRegexBuilder
Set the value for the Unicode (u
) flag.
fn size_limit(&mut self, limit: usize) -> &mut LazyRegexBuilder
Set the approximate size limit of the compiled regular expression.
This roughly corresponds to the number of bytes occupied by a single compiled program. If the program exceeds this number, then a compilation error is returned.
fn dfa_size_limit(&mut self, limit: usize) -> &mut LazyRegexBuilder
Set the approximate size of the cache used by the DFA.
This roughly corresponds to the number of bytes that the DFA will use while searching.
Note that this is a per thread limit. There is no way to set a global limit. In particular, if a regex is used from multiple threads simulanteously, then each thread may use up to the number of bytes specified here.
Trait Implementations
impl Clone for LazyRegexBuilder
[src]
fn clone(&self) -> LazyRegexBuilder
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0
Performs copy-assignment from source
. Read more
impl Eq for LazyRegexBuilder
[src]
impl PartialEq for LazyRegexBuilder
[src]
fn eq(&self, __arg_0: &LazyRegexBuilder) -> bool
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, __arg_0: &LazyRegexBuilder) -> bool
This method tests for !=
.