Oregano

Oregano is a BFS RegEx engine for the Beef programming language.

Usage

The Regex.Compile method is used to create regex objects.

let regex = Regex.Compile("([\"'])\w+\\1").GetValueOrDefault();

The IsMatch method is used to test if a string matches a regex.

if(regex.IsMatch("example string"))
{
    ...
}

The Match and Matches methods are used to get the match(es) in the specified string. (Note: the returned Match must be disposed)

for(let match in regex.Matches("example string"))
{
    ...
    match.Dispose();
}

The Replace method is used to replace the matched string(s) using a constant or a function

let str = scope String("example string")
regex.Replace(str, "replace string")
regex.Replace(str, scope (match, replaceStr) => { ... });

Supported regex features

Character classes

• . Matches any character except new line
• \d|\D Matches any digit | non-digit
• \w|\W Matches any alphanumeric | non-alphanumeric
• \s|\S Matches any whitespace | non-whitespace
• [xyz] Matches 'x', 'y', or 'z'
• [^xyz] Matches any other than 'x', 'y', or 'z'
• [a-z] Matches any between 'a' and 'z' inclusive

Quantifiers

• * Matches zero or more
• + Matches one or more
• ? Matches zero or one
• {m,n} Matches at least m and at most n
• *?|+?|??|{m,n}? Lazy quantifiers

Assertions

• ^ Start of line assertion
• $ End of line assertion
• \b Word boundary assertion
• \A Start of string assertion
• \Z End of string assertion

Groups

• (expr) Capturing group
• \1|\k<10> Backreference via index
• (?<name>expr) Named capturing group
• k<name> Backreference via name
• (?:expr) Non capturing group
• (?=expr) Lookahead
• (?!expr) Negative lookahead
• (?<=expr) Lookbehind
• (?<!expr) Negative Lookbehind