DEV Community

Cover image for The Complete Guide to Regular Expressions (Regex)
Corbin Crutchley for CoderPad

Posted on • Updated on • Originally published at coderpad.io

The Complete Guide to Regular Expressions (Regex)

A Regular Expression – or regex for short– is a syntax that allows you to match strings with specific patterns. Think of it as a suped-up text search shortcut, but a regular expression adds the ability to use quantifiers, pattern collections, special characters, and capture groups to create extremely advanced search patterns.
Regex can be used any time you need to query string-based data, such as:

  • Analyzing command line output
  • Parsing user input
  • Examining server or program logs
  • Handling text files with a consistent syntax, like a CSV
  • Reading configuration files
  • Searching and refactoring code

While doing all of these is theoretically possible without regex, when regexes hit the scene they act as a superpower for doing all of these tasks.

In this guide we'll cover:

Download our Regex Cheat Sheet

What does a regex look like?

In its simplest form, a regex in usage might look something like this:

We're using a regular expression /Test/ to look for the word "Test"

This screenshot is of the regex101 website. All future screenshots will utilize this website for visual reference.

In the "Test" example the letters test formed the search pattern, same as a simple search.
These regexes are not always so simple, however. Here's a regex that matches 3 numbers, followed by a "-", followed by 3 numbers, followed by another "-", finally ended by 4 numbers.

You know, like a phone number:

^(?:\d{3}-){2}\d{4}$
Enter fullscreen mode Exit fullscreen mode

The phone number "555-555-5555" will match with the regex above, but "555-abc-5555" will not

This regex may look complicated, but two things to keep in mind:

  1. We'll teach you how to read and write these in this article
  2. This is a fairly complex way of writing this regex.

In fact, most regexes can be written in multiple ways, just like other forms of programming. For example, the above can be rewritten into a longer but slightly more readable version:

^[0-9]{3}-[0-9]{3}-[0-9]{4}$
Enter fullscreen mode Exit fullscreen mode

Most languages provide a built-in method for searching and replacing strings using regex. However, each language may have a different set of syntaxes based on what the language dictates.

In this article, we'll focus on the ECMAScript variant of Regex, which is used in JavaScript and shares a lot of commonalities with other languages' implementations of regex as well.

How to read (and write) regexes

Quantifiers

Regex quantifiers check to see how many times you should search for a character.

Here is a list of all quantifiers:

  • a|b - Match either "a" or "b
  • ? - Zero or one
  • + - one or more
  • * - zero or more
  • {N} - Exactly N number of times (where N is a number)
  • {N,} - N or more number of times (where N is a number)
  • {N,M} - Between N and M number of times (where N and M are numbers and N < M)
  • *? - Zero or more, but stop after first match

For example, the following regex:

Hello|Goodbye
Enter fullscreen mode Exit fullscreen mode

Matches both the string "Hello" and "Goodbye".

Meanwhile:

Hey?
Enter fullscreen mode Exit fullscreen mode

Will track "y" zero to one time, so will match up with "He" and "Hey".

Alternatively:

Hello{1,3}
Enter fullscreen mode Exit fullscreen mode

Will match "Hello", "Helloo", "Hellooo", but not "Helloooo", as it is looking for the letter "o" between 1 and 3 times.

These can even be combined with one another:

He?llo{2}
Enter fullscreen mode Exit fullscreen mode

Here we're looking for strings with zero-to-one instances of "e" and the letter "o" times 2, so this will match "Helloo" and "Hlloo".

Greedy matching

One of the regex quantifiers we touched on in the previous list was the + symbol. This symbol matches one or more characters. This means that:

Hi+
Enter fullscreen mode Exit fullscreen mode

Will match everything from "Hi" to "Hiiiiiiiiiiiiiiii". This is because all quantifiers are considered "greedy" by default.

However, if you change it to be "lazy" using a question mark symbol (?) to the following, the behavior changes.

Hi+?
Enter fullscreen mode Exit fullscreen mode

Now, the i matcher will try to match as few times as possible. Since the + icon means "one or more", it will only match one "i". This means that if we input the string "Hiiiiiiiiiii", only "Hi" will be matched.

While this isn't particularly useful on its own, when combined with broader matches like the the . symbol, it becomes extremely important as we'll cover in the next section. The . symbol is used in regex to find "any character".

Now if you use:

H.*llo
Enter fullscreen mode Exit fullscreen mode

You can match everything from "Hillo" to "Hello" to "Hellollollo".

We're using a regex /H.*llo/ to look for the words "Hillo", "Hello", and "Helloollo"

However, what if you want to only match "Hello" from the final example?

Well, simply make the search lazy with a ? and it'll work as we want:

H.*?llo
Enter fullscreen mode Exit fullscreen mode

We're using a regex /H.*?llo/ to look for the words "Hillo", "Hello", and partially match the "Hello" in "Helloollo"

Pattern collections

Pattern collections allow you to search for a collection of characters to match against. For example, using the following regex:

My favorite vowel is [aeiou]
Enter fullscreen mode Exit fullscreen mode

You could match the following strings:

My favorite vowel is a
My favorite vowel is e
My favorite vowel is i
My favorite vowel is o
My favorite vowel is u
Enter fullscreen mode Exit fullscreen mode

But nothing else.

Here's a list of the most common pattern collections:

  • [A-Z] - Match any uppercase character from "A" to "Z"
  • [a-z] - Match any lowercase character from "a" to "z"
  • [0-9] - Match any number
  • [asdf] - Match any character that's either "a", "s", "d", or "f"
  • [^asdf] - Match any character that's not any of the following: "a", "s", "d", or "f"

You can even combine these together:

  • [0-9A-Z] - Match any character that's either a number or a capital letter from "A" to "Z"
  • [^a-z] - Match any non-lowercase letter

General tokens

Not every character is so easily identifiable. While keys like "a" to "z" make sense to match using regex, what about the newline character?

The "newline" character is the character that you input whenever you press "Enter" to add a new line.

  • . - Any character
  • \n - Newline character
  • \t - Tab character
  • \s - Any whitespace character (including \t, \n and a few others)
  • \S - Any non-whitespace character
  • \w - Any word character (Uppercase and lowercase Latin alphabet, numbers 0-9, and _)
  • \W - Any non-word character (the inverse of the \w token)
  • \b - Word boundary: The boundaries between \w and \W, but matches in-between characters
  • \B - Non-word boundary: The inverse of \b
  • ^ - The start of a line
  • $ - The end of a line
  • \\- The literal character "\"

So if you wanted to remove every character that starts a new word you could use something like the following regex:

\s.
Enter fullscreen mode Exit fullscreen mode

And replace the results with an empty string. Doing this, the following:

Hello world how are you
Enter fullscreen mode Exit fullscreen mode

Becomes:

Helloorldowreou
Enter fullscreen mode Exit fullscreen mode

We're using a regex /\s./ to look for the whitespaces alongside the following character in the string "Hello world how are you"

Combining with collections

These tokens aren't just useful on their own, though! Let's say that we want to remove any uppercase letter or whitespace character. Sure, we could write

[A-Z]|\s
Enter fullscreen mode Exit fullscreen mode

But we can actually merge these together and place our \s token into the collection:

[A-Z\s]
Enter fullscreen mode Exit fullscreen mode

We're using a regex /[A-Z\s]/ to look for uppercase letters and whitespaces in the string "Hello World how are you"

Word boundaries

In our list of tokens, we mentioned \b to match word boundaries. I thought I'd take a second to explain how it acts a bit differently from others.

Given a string like "This is a string", you might expect the whitespace characters to be matched – however, this isn't the case. Instead, it matches between the letters and the whitespace:

We're using a word boundary regex /\b/ to look for the in-between spaces in characters

This can be tricky to get your head around, but it's unusual to simply match against a word boundary. Instead, you might have something like the following to match full words:

\b\w+\b
Enter fullscreen mode Exit fullscreen mode

We're using a regex /\b\w+\b/ to look for full words. In the string "This is a string" we match "this", "is", "a", and "string"

You can interpret that regex statement like this:

"A word boundary. Then, one or more 'word' characters. Finally, another word boundary".

Start and end line

Two more tokens that we touched on are ^ and $. These mark off the start of a line and end of a line, respectively.

So, if you want to find the first word, you might do something like this:

^\w+
Enter fullscreen mode Exit fullscreen mode

To match one or more "word" characters, but only immediately after the line starts. Remember, a "word" character is any character that's an uppercase or lowercase Latin alphabet letters, numbers 0-9, and _.

The regex /^\w+/ matches the first word in the string. In "This is a string" we match "This"

Likewise, if you want to find the last word your regex might look something like this:

\w+$
Enter fullscreen mode Exit fullscreen mode

You can use /\w+$/ to match the last word in the string. In "This is a string" we match "string"

However, just because these tokens typically end a line doesn't mean that they can't have characters after them.

For example, what if we wanted to find every whitespace character between newlines to act as a basic JavaScript minifier?

Well, we can say "Find all whitespace characters after the end of a line" using the following regex:

$\s+
Enter fullscreen mode Exit fullscreen mode

We can use /$\s+/ to find all whitespace between the end of a string and the start of the next string.

Character escaping

While tokens are super helpful, they can introduce some complexity when trying to match strings that actually contain tokens. For example, say you have the following string in a blog post:

"The newline character is '\n'"
Enter fullscreen mode Exit fullscreen mode

Or want to find every instance of this blog post's usage of the "\n" string. Well, you can escape characters using \. This means that your regex might look something like this:

\\n
Enter fullscreen mode Exit fullscreen mode

How to use a regex

Regular expressions aren't simply useful for finding strings, however. You're also able to use them in other methods to help modify or otherwise work with strings.

While many languages have similar methods, let's use JavaScript as an example.

Creating and searching using regex

First, let's look at how regex strings are constructed.

In JavaScript (along with many other languages), we place our regex inside of // blocks. The regex searching for a lowercase letter looks like this:

/[a-z]/
Enter fullscreen mode Exit fullscreen mode

This syntax then generates a RegExp object which we can use with built-in methods, like exec, to match against strings.

/[a-z]/.exec("a"); // Returns ["a"]
/[a-z]/.exec("0"); // Returns null
Enter fullscreen mode Exit fullscreen mode

We can then use this truthiness to determine if a regex matched, like we're doing in line #3 of this example:

Run the associated code sample in a code sandbox

We can also alternatively call a RegExp constructor with the string we want to convert into a regex:

const regex = new RegExp("[a-z]"); // Same as /[a-z]/
Enter fullscreen mode Exit fullscreen mode

Replacing strings with regex

You can also use a regex to search and replace a file's contents as well. Say you wanted to replace any greeting with a message of "goodbye". While you could do something like this:

function youSayHelloISayGoodbye(str) {
  str = str.replace("Hello", "Goodbye");
  str = str.replace("Hi", "Goodbye");
  str = str.replace("Hey", "Goodbye");  str = str.replace("hello", "Goodbye");
  str = str.replace("hi", "Goodbye");
  str = str.replace("hey", "Goodbye");
  return str;
}
Enter fullscreen mode Exit fullscreen mode

There's an easier alternative, using a regex:

function youSayHelloISayGoodbye(str) {
  str = str.replace(/[Hh]ello|[Hh]i|[Hh]ey/, "Goodbye");
  return str;
}
Enter fullscreen mode Exit fullscreen mode

Run the associated code sample in a code sandbox

However, something you might notice is that if you run youSayHelloISayGoodbye with "Hello, Hi there": it won't match more than a single input:

An explanation for this image is in the next sentence. Apologies - there are issues with the markdown processing on this one

If the regex /[Hh]ello|[Hh]i|[Hh]ey/ is used on the string "Hello, Hi there", it will only match "Hello" by default.

Here, we should expect to see both "Hello" and "Hi" matched, but we don't.

This is because we need to utilize a Regex "flag" to match more than once.

Flags

A regex flag is a modifier to an existing regex. These flags are always appended after the last forward slash in a regex definition.

Here's a shortlist of some of the flags available to you.

  • g - Global, match more than once
  • m - Force $ and ^ to match each newline individually
  • i - Make the regex case insensitive

This means that we could rewrite the following regex:

/[Hh]ello|[Hh]i|[Hh]ey/
Enter fullscreen mode Exit fullscreen mode

To use the case insensitive flag instead:

/Hello|Hi|Hey/i
Enter fullscreen mode Exit fullscreen mode

With this flag, this regex will now match:

Hello
HEY
Hi
HeLLo
Enter fullscreen mode Exit fullscreen mode

Or any other case-modified variant.

Global regex flag with string replacing

As we mentioned before, if you do a regex replace without any flags it will only replace the first result:

let str = "Hello, hi there!";
str = str.replace(/[Hh]ello|[Hh]i|[Hh]ey/, "Goodbye");
console.log(str); // Will output "Goodbye, hi there"
Enter fullscreen mode Exit fullscreen mode

However, if you pass the global flag, you'll match every instance of the greetings matched by the regex:

let str = "Hello, hi there!";
str = str.replace(/[Hh]ello|[Hh]i|[Hh]ey/g, "Goodbye");
console.log(str); // Will output "Goodbye, Goodbye there"
Enter fullscreen mode Exit fullscreen mode

A note about JavaScript's global flag

When using a global JavaScript regex, you might run into some strange behavior when running the exec command more than once.

In particular, if you run exec with a global regex, it will return null every other time:

If we assign a regex to a variable then run  raw `exec` endraw  on said variable, it will find the results properly the first and third time, but return  raw `null` endraw  the second timeThis is because, as MDN explains:

JavaScript RegExp objects are stateful when they have the global or sticky flags set… They store a lastIndex from the previous match. Using this internally, exec() can be used to iterate over multiple matches in a string of text…

The exec command attempts to start looking through the lastIndex moving forward. Because lastIndex is set to the length of the string, it will attempt to match "" – an empty string – against your regex until it is reset by another exec command again. While this feature can be useful in specific niche circumstances, it's often confusing for new users.

To solve this problem, we can simply assign lastIndex to 0 before running each exec command:

If we run  raw `regex.lastIndex = 0` endraw  in between each  raw `regex.exec` endraw , then every single  raw `exec` endraw  runs as intended

Groups

When searching with a regex, it can be helpful to search for more than one matched item at a time. This is where "groups" come into play. Groups allow you to search for more than a single item at a time.

Here, we can see matching against both Testing 123 and Tests 123 without duplicating the "123" matcher in the regex.

/(Testing|tests) 123/ig
Enter fullscreen mode Exit fullscreen mode

With the regex /(Testing|tests) 123/ig we can match "Testing 123" and "Tests 123"Groups are defined by parentheses; there are two different types of groups--capture groups and non-capturing groups:

  • (...) - Group matching any three characters
  • (?:...) - Non-capturing group matching any three characters

The difference between these two typically comes up in the conversation when "replace" is part of the equation.

For example, using the regex above, we can use the following JavaScript to replace the text with "Testing 234" and "tests 234":

const regex = /(Testing|tests) 123/ig;

let str = `
Testing 123
Tests 123
`;

str = str.replace(regex, '$1 234');
console.log(str); // Testing 234\nTests 234"
Enter fullscreen mode Exit fullscreen mode

We're using $1 to refer to the first capture group, (Testing|tests). We can also match more than a single group, like both (Testing|tests) and (123):

const regex = /(Testing|tests) (123)/ig;

let str = `
Testing 123
Tests 123
`;

str = str.replace(regex, '$1 #$2');
console.log(str); // Testing #123\nTests #123"
Enter fullscreen mode Exit fullscreen mode

However, this is only true for capture groups. If we change:

/(Testing|tests) (123)/ig
Enter fullscreen mode Exit fullscreen mode

To become:

/(?:Testing|tests) (123)/ig;
Enter fullscreen mode Exit fullscreen mode

Then there is only one captured group – (123) – and instead, the same code from above will output something different:

const regex = /(?:Testing|tests) (123)/ig;

let str = `
Testing 123
Tests 123
`;

str = str.replace(regex, '$1');
console.log(str); // "123\n123"
Enter fullscreen mode Exit fullscreen mode

Run the associated code sample in a code sandbox

Named capture groups

While capture groups are awesome, it can easily get confusing when there are more than a few capture groups. The difference between $3 and $5 isn't always obvious at a glance.

To help solve for this problem, regexes have a concept called "named capture groups"

  • (?<name>...) - Named capture group called "name" matching any three characters

You can use them in a regex like so to create a group called "num" that matches three numbers:

/Testing (?<num>\d{3})/
Enter fullscreen mode Exit fullscreen mode

Then, you can use it in a replacement like so:

const regex = /Testing (?<num>\d{3})/
let str = "Testing 123";
str = str.replace(regex, "Hello $<num>")
console.log(str); // "Hello 123"
Enter fullscreen mode Exit fullscreen mode

Named back reference

Sometimes it can be useful to reference a named capture group inside of a query itself. This is where "back references" can come into play.

  • \k<name> Reference named capture group "name" in a search query

Say you want to match:

Hello there James. James, how are you doing?
Enter fullscreen mode Exit fullscreen mode

But not:

Hello there James. Frank, how are you doing?
Enter fullscreen mode Exit fullscreen mode

While you could write a regex that repeats the word "James" like the following:

/.*James. James,.*/
Enter fullscreen mode Exit fullscreen mode

A better alternative might look something like this:

/.*(?<name>James). \k<name>,.*/
Enter fullscreen mode Exit fullscreen mode

Now, instead of having two names hardcoded, you only have one.

Run the associated code sample in a code sandbox

Lookahead and lookbehind groups

Lookahead and behind groups are extremely powerful and often misunderstood.

There are four different types of lookahead and behinds:

  • (?!) - negative lookahead
  • (?=) - positive lookahead
  • (?<=) - positive lookbehind
  • (?<!) - negative lookbehind

Lookahead works like it sounds like: It either looks to see that something is after the lookahead group or is not after the lookahead group, depending on if it's positive or negative.

As such, using the negative lookahead like so:

/B(?!A)/
Enter fullscreen mode Exit fullscreen mode

Will allow you to match BC but not BA.

With the regex /B(?!A)/ we can match "B" in "BC" but not in "BA"

You can even combine these with ^ and $ tokens to try to match full strings. For example, the following regex will match any string that does not start with "Test"

/^(?!Test).*$/gm
Enter fullscreen mode Exit fullscreen mode

/^(?!Test).*$/gm lets us match "Hello" and "Other", but not "Testing 123" and "Tests 123"

Likewise, we can switch this to a positive lookahead to enforce that our string must start with "Test"

/^(?=Test).*$/gm
Enter fullscreen mode Exit fullscreen mode

Inversing our previous item - /^(?=Test).*$/gm lets us match "Testing 123" and "Tests 123", but not "Hello" and "Other"

Putting it all together

Regexes are extremely powerful and can be used in a myriad of string manipulations. Knowing them can help you refactor codebases, script quick language changes, and more!

Let's go back to our initial phone number regex and try to understand it again:

^(?:\d{3}-){2}\d{4}$
Enter fullscreen mode Exit fullscreen mode

Remember that this regex is looking to match phone numbers such as:

555-555-5555
Enter fullscreen mode Exit fullscreen mode

Here this regex is:

  • Using ^ and $ to define the start and end of a regex line.
  • Using a non-capturing group to find three digits then a dash
    • Repeating this group twice, to match 555-555-
  • Finding the last 4 digits of the phone number

Hopefully, this article has been a helpful introduction to regexes for you. If you'd like to see quick definitions of useful regexes, check out our cheat sheet.

Download our Regex Cheat Sheet

Oldest comments (9)

Collapse
 
lexlohr profile image
Alex Lohr

Once you finally understand regex, the second part to learn is not to overuse them and to resist the temptation to use them on irregular problems, e.g. parsing JS or HTML.

Collapse
 
jesseholden profile image
Jesse Holden

Awesome post! I was just dealing with Regex yesterday and ran into a situation that I wanted a non-capture group but the Regex documentation wasn't very clear so I couldn't figure that out. Learned a lot from this post that will definitely help me optimize some of my Regex code!

Collapse
 
blitzdex27 profile image
Dekstur

Hello, I think you missed something here. I tried your code and the output is : "Goodbye, Goodbye there!". By the way, thanks for sharing! This materials is easier to learn.

let str = "Hello, hi there!";
str = str.replace(/[Hh]ello|[Hh]i|[Hh]ey/g, "Goodbye");
console.log(str); // Will output "Goodbye, hi there"

Collapse
 
crutchcorn profile image
Corbin Crutchley

Whoops! Yup, it should be "Goodbye, Goodbye there!" for sure. I'll update that.

Thanks for reading and letting me know!

Collapse
 
blitzdex27 profile image
Dekstur

No problem! it was a good read. Thanks too!

Collapse
 
aaravrrrrrr profile image
Aarav Reddy

Thanks for the read.

Collapse
 
dxcqcv profile image
Roy

Group matching any three characters, but Testing is 7 characters in /(Testing|tests) (123)/ig, so why?

Collapse
 
crutchcorn profile image
Corbin Crutchley

Sorry for the confusion!

(...) literally is "Any three characters" because each . is "any character".

(hello) would match "hello"

() is just a capturing group in general, not just for any three characters.

I could've written clearer, sorry!

Collapse
 
gumonet profile image
Angel Gutierrez

Thanks for sharing! I loved it, is very clear. Thanks!