Struct grep_regex::RegexMatcher [−][src]
pub struct RegexMatcher { /* fields omitted */ }
Expand description
An implementation of the Matcher
trait using Rust’s standard regex
library.
Implementations
Create a new matcher from the given pattern using the default configuration.
Create a new matcher from the given pattern using the default
configuration, but matches lines terminated by \n
.
This is meant to be a convenience constructor for using a
RegexMatcherBuilder
and setting its
line_terminator
to \n
. The purpose of using this constructor is to permit special
optimizations that help speed up line oriented search. These types of
optimizations are only appropriate when matches span no more than one
line. For this reason, this constructor will return an error if the
given pattern contains a literal \n
. Other uses of \n
(such as in
\s
) are removed transparently.
Trait Implementations
type Captures = RegexCaptures
type Captures = RegexCaptures
The concrete type of capturing groups used for this matcher. Read more
Returns the start and end byte range of the first match in haystack
after at
, where the byte offsets are relative to that start of
haystack
(and not at
). If no match exists, then None
is returned. Read more
Creates an empty group of captures suitable for use with the capturing APIs of this trait. Read more
Returns the total number of capturing groups in this matcher. Read more
Maps the given capture group name to its corresponding capture group
index, if one exists. If one does not exist, then None
is returned. Read more
Returns the start and end byte range of the first match in haystack
.
If no match exists, then None
is returned. Read more
Executes the given function over successive non-overlapping matches
in haystack
. If no match exists, then the given function is never
called. If the function returns false
, then iteration stops. Read more
Executes the given function over successive non-overlapping matches
in haystack
. If no match exists, then the given function is never
called. If the function returns false
, then iteration stops.
Similarly, if the function returns an error then iteration stops and
the error is yielded. If an error occurs while executing the search,
then it is converted to
E
. Read more
Populates the first set of capture group matches from haystack
into
caps
. If no match exists, then false
is returned. Read more
fn captures_iter<F>(
&self,
haystack: &[u8],
caps: &mut RegexCaptures,
matched: F
) -> Result<(), NoError> where
F: FnMut(&RegexCaptures) -> bool,
[src]
fn captures_iter<F>(
&self,
haystack: &[u8],
caps: &mut RegexCaptures,
matched: F
) -> Result<(), NoError> where
F: FnMut(&RegexCaptures) -> bool,
[src]Executes the given function over successive non-overlapping matches
in haystack
with capture groups extracted from each match. If no
match exists, then the given function is never called. If the function
returns false
, then iteration stops. Read more
fn try_captures_iter<F, E>(
&self,
haystack: &[u8],
caps: &mut RegexCaptures,
matched: F
) -> Result<Result<(), E>, NoError> where
F: FnMut(&RegexCaptures) -> Result<bool, E>,
[src]
fn try_captures_iter<F, E>(
&self,
haystack: &[u8],
caps: &mut RegexCaptures,
matched: F
) -> Result<Result<(), E>, NoError> where
F: FnMut(&RegexCaptures) -> Result<bool, E>,
[src]Executes the given function over successive non-overlapping matches
in haystack
with capture groups extracted from each match. If no
match exists, then the given function is never called. If the function
returns false
, then iteration stops. Similarly, if the function
returns an error then iteration stops and the error is yielded. If
an error occurs while executing the search, then it is converted to
E
. Read more
fn captures_at(
&self,
haystack: &[u8],
at: usize,
caps: &mut RegexCaptures
) -> Result<bool, NoError>
[src]
fn captures_at(
&self,
haystack: &[u8],
at: usize,
caps: &mut RegexCaptures
) -> Result<bool, NoError>
[src]Populates the first set of capture group matches from haystack
into matches
after at
, where the byte offsets in each capturing
group are relative to the start of haystack
(and not at
). If no
match exists, then false
is returned and the contents of the given
capturing groups are unspecified. Read more
Replaces every match in the given haystack with the result of calling
append
. append
is given the start and end of a match, along with
a handle to the dst
buffer provided. Read more
Replaces every match in the given haystack with the result of calling
append
with the matching capture groups. Read more
Returns true if and only if the matcher matches the given haystack. Read more
Returns true if and only if the matcher matches the given haystack starting at the given position. Read more
Returns an end location of the first match in haystack
. If no match
exists, then None
is returned. Read more
Returns an end location of the first match in haystack
starting at
the given position. If no match exists, then None
is returned. Read more
If available, return a set of bytes that will never appear in a match produced by an implementation. Read more
If this matcher was compiled as a line oriented matcher, then this
method returns the line terminator if and only if the line terminator
never appears in any match produced by this matcher. If this wasn’t
compiled as a line oriented matcher, or if the aforementioned guarantee
cannot be made, then this must return None
, which is the default.
It is never wrong to return None
, but returning a line terminator
when it can appear in a match results in unspecified behavior. Read more
Return one of the following: a confirmed line match, a candidate line match (which may be a false positive) or no match at all (which must not be a false negative). When reporting a confirmed or candidate match, the position returned can be any position in the line. Read more
Executes the given function over successive non-overlapping matches
in haystack
. If no match exists, then the given function is never
called. If the function returns false
, then iteration stops. Read more
Executes the given function over successive non-overlapping matches
in haystack
. If no match exists, then the given function is never
called. If the function returns false
, then iteration stops.
Similarly, if the function returns an error then iteration stops and
the error is yielded. If an error occurs while executing the search,
then it is converted to
E
. Read more
Executes the given function over successive non-overlapping matches
in haystack
with capture groups extracted from each match. If no
match exists, then the given function is never called. If the function
returns false
, then iteration stops. Read more
Executes the given function over successive non-overlapping matches
in haystack
with capture groups extracted from each match. If no
match exists, then the given function is never called. If the function
returns false
, then iteration stops. Similarly, if the function
returns an error then iteration stops and the error is yielded. If
an error occurs while executing the search, then it is converted to
E
. Read more
Replaces every match in the given haystack with the result of calling
append
with the matching capture groups. Read more
Auto Trait Implementations
impl RefUnwindSafe for RegexMatcher
impl Send for RegexMatcher
impl Sync for RegexMatcher
impl Unpin for RegexMatcher
impl UnwindSafe for RegexMatcher
Blanket Implementations
Mutably borrows from an owned value. Read more