.NET
System.Text.RegularExpressions- About
- Backtracking engine, run with RegexOptions.CultureInvariant.
- Verified on
- .NET 10.0.15
Offsets are counted in UTF-16 code units. - Found in
- C#, F#, PowerShell
its own documentation - Flags
iignore casemmultilinenexplicit capturesdotallxverbose
Character classes 10 of 26
| Syntax | Matches | Notes | Try |
|---|---|---|---|
. |
Any characterAny single character. Whether that includes a newline depends on the dialect and its flags. | Does not match a newline. |
test |
[abc]not[^abc] |
One of a set of characters | test | |
[a-z] |
One of a range of characters | test | |
[\]] |
Backslash escape inside a setInside a bracket expression a backslash takes the special meaning from the next character. Where this is missing, a backslash there is a member like any other. | test | |
[\d] |
Class escape inside a setA class escape such as the one for a digit, used as a member of a bracket expression. | test | |
[\D] |
Negated class escape inside a setA negated class escape, such as the one for anything but a digit, used as a member of a bracket expression. | test | |
\dnot\D |
Digit | Matches the decimal digits of every script, not only |
test |
\wnot\W |
Word characterA letter, a digit or an underscore. | Unicode-aware: matches letters and digits of every script. |
test |
\snot\S |
Whitespace | Also matches the no-break space. |
test |
| n/a | Horizontal whitespaceA space or a tab, but not a line break. | not in .NET Tried: |
who has it |
| n/a | Vertical whitespaceA line break character of any kind. | not in .NET Tried: |
who has it |
| n/a | Any character except newlineNever matches a newline, whatever the flags. | not in .NET Tried: |
who has it |
| n/a | Any line break sequenceOne line break, with CR LF taken as a single unit. | not in .NET Tried: |
who has it |
| n/a | Alphabetic character (shorthand) | not in .NET Tried: |
who has it |
| n/a | Lowercase letter (shorthand) | not in .NET Tried: |
who has it |
| n/a | Uppercase letter (shorthand) | not in .NET Tried: |
who has it |
| n/a | Hexadecimal digit (shorthand) | not in .NET Tried: |
who has it |
| n/a | Class intersectionCharacters that are in both classes. | not in .NET Tried: |
who has it |
[X-[Y]] |
Class subtractionCharacters in the first class that are not in the second. | test | |
| n/a | Head-of-word character (shorthand)A letter or the underscore: what a word may start with. | not in .NET Tried: |
who has it |
| n/a | Octal digit (shorthand) | not in .NET Tried: |
who has it |
| n/a | Identifier characterA character allowed in an identifier. In Vim the set comes from the 'isident' option. | not in .NET Tried: |
who has it |
| n/a | Keyword characterA character allowed in a keyword. In Vim the set comes from the 'iskeyword' option. | not in .NET Tried: |
who has it |
| n/a | File name characterA character allowed in a file name. In Vim the set comes from the 'isfname' option. | not in .NET Tried: |
who has it |
| n/a | Printable characterA character that is displayed as itself. In Vim the set comes from the 'isprint' option. | not in .NET Tried: |
who has it |
| n/a | Any single byteOne code unit, even where that is part of a longer character, and even a newline. | not in .NET Tried: |
who has it |
Anchors 8 of 14
| Syntax | Matches | Notes | Try |
|---|---|---|---|
^ |
Start of the text or lineStart of the text. With a multiline flag, or always in some dialects, also the start of each line. | test | |
$ |
End of the text or line | Also matches before a newline that ends the text. |
test |
\A |
Start of the textStart of the text only, whatever the flags. | test | |
\z |
End of the textThe very end of the text, whatever the flags. | test | |
\Z |
End of the text, or before a final newline | test | |
\b |
Word boundaryThe position between a word character and a non-word character or an end of the text. | Unicode-aware: a letter outside ASCII is a word character. |
test |
\B |
Not a word boundary | test | |
| n/a | Start of a word | not in .NET Tried: |
who has it |
| n/a | End of a word | not in .NET Tried: |
who has it |
\G |
Where the previous match endedThe position where the last match stopped, or the start of the text for the first match. | test | |
| n/a | Reset the start of the matchEverything matched so far is required but left out of the reported match. | not in .NET Tried: |
who has it |
| n/a | Start of symbolBefore a run of word and symbol characters, such as an identifier with an underscore in it. | not in .NET Tried: |
who has it |
| n/a | End of symbol | not in .NET Tried: |
who has it |
| n/a | Cursor positionWhere the editor's cursor is in the buffer being searched. | not in .NET The nearest anchor is doc Not run on an engine: taken from the documentation. |
who has it |
Quantifiers 8 of 9
| Syntax | Matches | Notes | Try |
|---|---|---|---|
X? |
Zero or one | test | |
X* |
Zero or more | test | |
X+ |
One or more | test | |
X{N} |
Exactly N times | test | |
X{N,} |
N or more times | test | |
X{0,M} |
At most M times | test | |
X{N,M} |
Between N and M times | test | |
X*?X+?X?? |
Lazy quantifierRepeat as few times as possible instead of as many as possible. | test | |
| n/a | Possessive quantifierRepeat as many times as possible and never give any of it back. | not in .NET Tried: |
who has it |
Groups and alternation 10 of 16
| Syntax | Matches | Notes | Try |
|---|---|---|---|
(X) |
Capture group | test | |
(?:X) |
Non-capturing group | test | |
(?<NAME>X)(?'NAME'X) |
Named capture group | Named groups are numbered after all the unnamed ones, whatever their order in the pattern. |
test |
X|Y |
Alternation | Takes the first alternative that matches, even when a later one is longer. |
test |
\N |
Backreference by numberThe same text that capture group N matched. | test | |
\k<NAME>\k'NAME' |
Backreference by name | test | |
| n/a | Backreference by relative positionThe group N groups back from here. | not in .NET Tried: |
who has it |
(?>X) |
Atomic groupOnce the group has matched, the engine never tries a different way to match it. | test | |
| n/a | Branch reset groupEvery alternative numbers its capture groups from the same start. | not in .NET Tried: |
who has it |
(?(N)X|Y) |
ConditionalMatch one pattern if a capture group took part, otherwise another. | test | |
| n/a | Recurse into the whole pattern | not in .NET Tried: |
who has it |
| n/a | Call a group as a subroutineMatch the pattern of capture group N again at this point, not the text it matched. | not in .NET Tried: |
who has it |
(?#TEXT) |
Comment | test | |
(?<N>X) |
Explicitly numbered groupA capture group that is given its number, whatever its position. | test | |
| n/a | Call an earlier group by relative positionMatch the pattern of the Nth group before this point again. | not in .NET Tried: |
who has it |
| n/a | Call a later group by relative positionMatch the pattern of the Nth group after this point here as well. | not in .NET Tried: |
who has it |
Lookaround 4 of 4
Escape sequences 14 of 16
| Syntax | Matches | Notes | Try |
|---|---|---|---|
\. |
Escape a special characterTake the next character literally. | test | |
| n/a | Quote a run of textTake everything between the markers literally. | not in .NET Tried: |
who has it |
\t |
Tab | test | |
\n |
Newline | test | |
\r |
Carriage return | test | |
\f |
Form feed | test | |
\v |
Vertical tab | test | |
\a |
Alert (bell) | test | |
[\b] |
Backspace | test | |
\e |
Escape character | test | |
\cC |
Control characterThe control character typed as Ctrl plus the letter. | test | |
\OOO |
Character by octal code | test | |
\xHH |
Character by two-digit hex code | test | |
\uHHHH |
Character by Unicode code point | test | |
| n/a | Character by Unicode name | not in .NET Tried: |
who has it |
\x00\u0000\000 |
NUL characterThe character with code 0. | The octal form is documented with two or three digits and a single digit is described as a backreference, so a bare doc Not run on an engine: taken from the documentation. |
Flags and modes 10 of 14
| Syntax | Matches | Notes | Try |
|---|---|---|---|
flag i(?i) |
Ignore case | test | |
flag m(?m) |
MultilineThe line anchors also match at the start and end of every line. | test | |
flag s(?s) |
Dot matches newline | test | |
flag x(?x) |
Free spacingWhitespace in the pattern is ignored, and a # starts a comment. | test | |
| n/a | Swap greedy and lazy | not in .NET Tried: |
who has it |
(?FLAGS) |
Turn a mode on inside the patternApplies from this point to the end of the pattern or the enclosing group. | test | |
(?FLAGS) |
Turn a mode on in the middle of the patternThe mode applies from where the flag stands, not to what comes before it. Some dialects accept an inline flag only at the very start of the pattern. | test | |
(?FLAGS:X) |
Turn a mode on for one group | test | |
(?-FLAGS) |
Turn a mode off inside the pattern | test | |
| n/a | ASCII-only classesMakes the shorthand classes such as the digit class match ASCII characters only. | not in .NET Tried: |
who has it |
| n/a | Unicode classesMakes the shorthand classes such as the digit class match by Unicode property. | not in .NET
Tried: |
who has it |
(?n) |
No automatic capturePlain parentheses group without capturing; only named groups capture. | test | |
RegexOptions.IgnoreCase(?i) |
Locale-dependent classesClasses and case folding follow the current locale. | partial Case folding only, and it is the default: case-insensitive matching uses the casing conventions of the current culture unless doc Not run on an engine: taken from the documentation. |
|
| n/a | Native character set rulesPerl's rules from before 5.14: the pattern and the text decide between native and Unicode rules. | not in .NET doc Not run on an engine: taken from the documentation. |
who has it |
POSIX named classes 0 of 1
| Syntax | Matches | Notes | Try |
|---|---|---|---|
| n/a | POSIX named classA named set of characters, written inside a bracket expression. | not in .NET Tried: |
who has it |
POSIX collating symbols 0 of 2
| Syntax | Matches | Notes | Try |
|---|---|---|---|
| n/a | Equivalence classEvery character that collates the same as X in the current locale. | not in .NET Tried: |
who has it |
| n/a | Collating symbol by nameA single collating element, written by its POSIX name inside a bracket expression. | not in .NET Tried: |
who has it |
Unicode properties 1 of 4
| Syntax | Matches | Notes | Try |
|---|---|---|---|
\p{NAME}not\P{NAME} |
Unicode general category | 36 names: |
test |
| n/a | Unicode script | not in .NET
The bare script name is not a known property. U+1F00 is a Greek letter, but it is in the Greek Extended block. List the blocks that make up the script, for example |
who has it |
| n/a | Extended grapheme clusterOne character as a reader sees it: a base character with its combining marks. | not in .NET Tried: |
who has it |
| n/a | Unicode text boundaryA boundary as Unicode's segmentation rules define it, which is not the same as a boundary between word and non-word characters. | not in .NET Tried: |
who has it |
Syntax table classes 0 of 2
| Syntax | Matches | Notes | Try |
|---|---|---|---|
| n/a | Syntax classA character with the given role in the syntax table: whitespace, word, symbol, punctuation, a bracket. | not in .NET Tried: |
who has it |
| n/a | Character categoryA character in one of the editor's character categories, most of which are scripts. | not in .NET Tried: |
who has it |
Host language 9 of 15
| Syntax | Matches | Notes | Try |
|---|---|---|---|
@"PATTERN""""PATTERN""""PATTERN" |
Pattern in source codeHow a pattern is written where it is used: a regex literal with its delimiters, or the kind of string the documentation recommends. | No regex literal; C# string forms shown. In a verbatim string a backslash is literal and a double quote is doubled as doc Not run on an engine: taken from the documentation. |
|
new Regex(PATTERN, FLAGS)Regex.IsMatch(TEXT, PATTERN, FLAGS) |
Flags outside the patternWhere flags such as case-insensitive go when they are not written inside the pattern. | FLAGS is a bitwise OR of doc Not run on an engine: taken from the documentation. |
|
new Regex(PATTERN)new Regex(PATTERN, RegexOptions.Compiled)[GeneratedRegex(PATTERN)] |
Compile once and reuseBuild a pattern object and keep it. | A doc Not run on an engine: taken from the documentation. |
|
Regex.IsMatch(TEXT, PATTERN)Regex.Match(TEXT, PATTERN) |
Search a textTest whether the pattern matches anywhere in a text, or get the first match. | Not anchored; the text comes first in the argument list. doc Not run on an engine: taken from the documentation. |
|
Regex.Matches(TEXT, PATTERN) |
Every matchGet all the matches that do not overlap. | Returns a doc Not run on an engine: taken from the documentation. |
|
Regex.Replace(TEXT, PATTERN, REPLACEMENT)new Regex(PATTERN).Replace(TEXT, REPLACEMENT, 1) |
Replace matches | Replaces every match. The instance overload with a count argument limits the number of replacements; pass 1 for the first only. doc Not run on an engine: taken from the documentation. |
|
m.Groups[NUM].Valuem.Groups["NAME"].Value |
Captured group, in codeRead what a group captured after a match. |
doc Not run on an engine: taken from the documentation. |
|
$NUM${NAME}${NUM} |
Captured group, in replacement text | All digits after doc Not run on an engine: taken from the documentation. |
|
$& |
Whole match, in replacement text | A literal dollar sign is written doc Not run on an engine: taken from the documentation. |
|
| n/a | Match once until resetA match operator that succeeds one time only, until it is reset. | not in .NET doc Not run on an engine: taken from the documentation. |
who has it |
| n/a | Keep the position after a failed matchIn a repeated search, a failed match does not send the next one back to the start. | not in .NET A doc Not run on an engine: taken from the documentation. |
who has it |
| n/a | Keep the matched text for laterAsk for the matched text, and the text around it, to be saved. | not in .NET No flag is needed or offered: doc Not run on an engine: taken from the documentation. |
who has it |
| n/a | Interpolate and compile only onceA pattern literal with variables in it is built the first time and never again. | not in .NET Patterns are strings with no once-only interpolation. Keep a doc Not run on an engine: taken from the documentation. |
who has it |
| n/a | Code inside a patternHost-language code that runs when the match reaches it. | not in .NET Code runs per match only outside the pattern, through a doc Not run on an engine: taken from the documentation. |
who has it |
| n/a | Pattern computed during the matchCode inside the pattern whose result is matched as a pattern at that point. | not in .NET doc Not run on an engine: taken from the documentation. |
who has it |
Every row was run on the engine named above, except the rows marked doc: those describe something no regex engine can run by itself, such as the syntax of the host language, and are taken from the documentation they link to. For a row marked "not in .NET", the spelling other dialects use was tried and the line starting "Tried" says what it did here; that shows the spelling does not work, not that no other spelling exists.