The base combinator for doing regex searches. It's a traversal which selects Matches; you can compose it with match or groups to get the relevant parts of your match.

Getting all matches: > > "one _two_ three _four_" ^.. regex [rx|_w+_|] . match > ["_two_","_four_"]

Regex replace/mutation > > "one _two_ three _four_" & regex [rx|_w+_|] . match %~ T.toUpper > "one _TWO_ three _FOUR_"

Getting groups with their group index. > > "12 and 34" ^.. regex [rx|(d+)/(d+)|] . igroups . withIndex > [(0,"1"),(1,"2"),(0,"3"),(1,"4")]

Check for any matches: > > has (regex [rx|ne+dle|]) "a needle in a haystack" > True

Check for matches which also match a predicate: > > has (regex [rx|w+|] . match . filtered ((> 7) . T.length)) "one word here is loooooooong" > True

Get the third match > > "alpha beta charlie delta" ^? (iregex [rx|w+|] . index 2 . match) > Just "charlie"

Replace the third match > > "alpha beta charlie delta" & (iregex [rx|w+|] . index 2 . match) .~ GAMMA > "alpha beta GAMMA delta"

Match integers, Read them into ints, then sort each match in-place > > "Monday: 29, Tuesday: 99, Wednesday: 3" & partsOf' (iregex [rx|d+|] . match . unpacked . _Show @Int) %~ sort > "Monday: 3, Tuesday: 29, Wednesday: 99"

Indexed version of regex.

Traverse each match as a whole

Use with regex or iregex

> "one _two_ three _four_" ^.. regex [rx|_\w+_|] . match
["_two_","_four_"]

You can edit the traversal to perform a regex replace/substitution > > "one _two_ three _four_" & regex [rx|_w+_|] . match %~ T.toUpper > "one _TWO_ three _FOUR_"

traverse each group within a match. See igroups for selecting specific groups.

groups but indexed by the group number. If you traverse over many matches you will encounter duplicate indices. E.g.

> "a 1 b 2" ^.. regex [rx|(\w) (\d)|] . igroups . withIndex
[(0,"a"),(1,"1"),(0,"b"),(1,"2")]

If you want only a specific group; combine this with index E.g.

> "a 1 b 2" ^.. regex [rx|(\w) (\d)|] . igroups . index 0
["a","b"]

QuasiQuoter for compiling regexes. This is just re re-exported under a different name so as not to conflict with re from Lens

Match represents a whole regex match; you can drill into it using match or groups