Struct Regex

pub struct Regex { /* private fields */ }

POSIX regular expression.

Implementations

impl Regex

pub fn new(pattern: &str, flags: CompFlags) -> Result<Regex, String>

Compiles pattern as a regular expression.

By default, pattern is assumed to be a basic regular expression. To interpret it as an extended regular expression, add CompFlags::EXTENDED to the flags. See also other CompFlags values to control some other aspects of the regex.

Returns

Compiled regex or an error message.

pub fn matches( &self, input: &str, max_matches: usize, flags: MatchFlags, ) -> Result<Vec<Match>, String>

Matches input string against regex, looking for up to max_matches matches.

Regexes can contain parenthesized subexpressions. This method will return up to max_matches-1 of those. First match is reserved for the text that the whole regex matched.

flags dictate how matching is performed. See MatchFlags for details.

Returns

• Ok with an empty vector if no match found, or if max_matches is 0 and there were no errors.
• Ok with a non-empty vector if max_matches was non-zero and a match was found. First element of the vector is the text that regex as a whole matched. The rest of the elements are pieces of text that were matched by parenthesized subexpressions.
• Err with an error message.

Trait Implementations

impl Drop for Regex

fn drop(&mut self)

Executes the destructor for this type.