Struct Pattern 

pub struct Pattern { /* private fields */ }

A compiled regular expression — the payload of Value::Pattern.

Every regex operation in the runtime goes through this type, so swapping engines is confined to this file.

Implementations

impl Pattern

pub fn new(pattern: &str) -> Result<Pattern, PatternError>

Compile pattern.

pub fn as_str(&self) -> &str

The pattern source, as written in the #"…" literal.

pub fn captures<'h>(&self, haystack: &'h str) -> Option<Captures<'h>>

Leftmost match anywhere in haystack.

pub fn captures_full<'h>(&self, haystack: &'h str) -> Option<Captures<'h>>

Match the whole of haystack, or nothing — Java’s Matcher.matches(), which Clojure’s re-matches delegates to.

Anchored inside the pattern rather than by checking the span of an unanchored match, because the two differ wherever the engine’s leftmost-first preference picks a shorter alternative: a|ab prefers a, and .*?x? prefers the empty match, neither of which reaches the end of the haystack even though a full match exists. With \A/\z in the automaton the engine only ever offers a whole-haystack match.

pub fn captures_at<'h>( &self, haystack: &'h str, start: usize, ) -> Option<Captures<'h>>

Leftmost match at or after byte offset start. Look-around still sees the text before start, which is what makes this the right primitive for stepping a Matcher forward.

pub fn replace<'h>(&self, haystack: &'h str, replacement: &str) -> Cow<'h, str>

Replace the leftmost match in haystack; $1-style references in replacement expand to capture groups.

pub fn replace_all<'h>( &self, haystack: &'h str, replacement: &str, ) -> Cow<'h, str>

Replace every non-overlapping match in haystack.

pub fn split<'h>(&self, haystack: &'h str) -> impl Iterator<Item = &'h str>

Split haystack around each match.

pub fn splitn<'h>( &self, haystack: &'h str, limit: usize, ) -> impl Iterator<Item = &'h str>

Split haystack around each match, yielding at most limit pieces; the last piece holds the unsplit remainder.

Trait Implementations

impl Clone for Pattern

fn clone(&self) -> Pattern

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Pattern

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Pattern

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Trace for Pattern

fn trace(&self, _: &mut MarkVisitor)

fn gc_size_extra(&self) -> usize