Create a Regex that matches patterns as specified in JavaScript.

Be careful to escape backslashes properly! For example, "\w" is escaping the letter w which is probably not what you want. You probably want "\\w" instead, which escapes the backslash.

Escape strings to be regular expressions, making all special characters safe. So regex (escape "^a+") will match exactly "^a+" instead of a series of a’s that start at the beginning of the line.

Make a regex case insensitive

HowMany is used to specify how many matches you want to make. So replace All would replace every match, but replace (AtMost 2) would replace at most two matches (i.e. zero, one, two, but never three or more).

A Match represents all of the details about a particular match in a string. Here are details on each field:

* match — the full string of the match. * submatches — a regex might have subpatterns, surrounded by parentheses. If there are N subpatterns, there will be N elements in the submatches list. Each submatch in this list is a Maybe because not all subpatterns may trigger. For example, (regex "(a+)|(b+)") will either match many a’s or many b’s, but never both. * index — the index of the match in the original string. * number — if you find many matches, you can think of each one as being labeled with a number starting at one. So the first time you find a match, that is match number one. Second time is match number two. This is useful when paired with replace All if replacement is dependent on how many times a pattern has appeared before.

Check to see if a Regex is contained in a string.

contains (regex "123") "12345" == True
contains (regex "b+") "aabbcc" == True


contains (regex "789") "12345" == False
contains (regex "z+") "aabbcc" == False

Find matches in a string:

findTwoCommas = find (AtMost 2) (regex ",")


  -- map .index (findTwoCommas "a,b,c,d,e") == [1,3]
  -- map .index (findTwoCommas "a b c d e") == []


places = find All (regex "[oi]n a (\\w+)") "I am on a boat in a lake."


  -- map .match places == ["on a boat", "in a lake"]
  -- map .submatches places == [ [Just "boat"], [Just "lake"] ]

Replace matches. The function from Match to String lets you use the details of a specific match when making replacements.

devowel = replace All (regex "[aeiou]") (\_ -> "")


  -- devowel "The quick brown fox" == "Th qck brwn fx"


reverseWords = replace All (regex "\\w+") (\{match} -> String.reverse match)


  -- reverseWords "deliver mined parts" == "reviled denim strap"

Split a string, using the regex as the separator.

split (AtMost 1) (regex ",") "tom,99,90,85" == ["tom","99,90,85"]


split All (regex ",") "a,b,c,d" == ["a","b","c","d"]