Struct RegexMatcher 

pub struct RegexMatcher { /* private fields */ }

Matcher that finds AST nodes based on regex patterns applied to their text content.

RegexMatcher enables flexible text-based searching within AST nodes. It matches any node whose text content satisfies the provided regular expression.

Examples

// Match numeric literals
let numbers = RegexMatcher::try_new(r"^\d+$")?;
let numeric_nodes: Vec<_> = root.find_all(&numbers).collect();

// Find TODO comments
let todos = RegexMatcher::try_new(r"(?i)todo|fixme")?;
let todo_comments: Vec<_> = root.find_all(&todos).collect();

// Match specific naming patterns
let private_vars = RegexMatcher::try_new(r"^_\w+")?;
let private_variables: Vec<_> = root.find_all(&private_vars).collect();

Performance Note

Text matching requires extracting text from every tested node, which can be slower than structural matching. Consider combining with other matchers or using more specific patterns when possible.

Implementations

impl RegexMatcher

pub fn try_new(text: &str) -> Result<Self, RegexMatcherError>

Trait Implementations

impl Clone for RegexMatcher

fn clone(&self) -> RegexMatcher

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RegexMatcher

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

Formats the value using the given formatter.

impl Matcher for RegexMatcher

fn match_node_with_env<'tree, D: Doc>( &self, node: Node<'tree, D>, _env: &mut Cow<'_, MetaVarEnv<'tree, D>>, ) -> Option<Node<'tree, D>>

Attempt to match a node, updating the meta-variable environment.

fn potential_kinds(&self) -> Option<BitSet>

Provide a hint about which node types this matcher can match.

fn get_match_len<D: Doc>(&self, _node: Node<'_, D>) -> Option<usize>

Determine how much of a matched node should be replaced.