Regular Expression in Java – Java Regex Example

Filed Under: Java

Welcome to Regular Expression in Java. It’s also called Regex in Java. When I started programming, java regular expression was a nightmare for me. This tutorial is aimed to help you master Regular Expression in Java. I will also come back here to refresh my Java Regex learning.

Regular Expression in Java

Regular Expression in Java, regex in java, java regex example, regex java, regular expression java

The regular expression in java defines a pattern for a String. Regular Expression can be used to search, edit or manipulate text. A regular expression is not language specific but they differ slightly for each language. Regular Expression in Java is most similar to Perl.

Java Regex classes are present in java.util.regex package that contains three classes:

  1. Pattern: Pattern object is the compiled version of the regular expression. Pattern class doesn’t have any public constructor and we use it’s public static method compile to create the pattern object by passing regular expression argument.
  2. Matcher: Matcher is the java regex engine object that matches the input String pattern with the pattern object created. Matcher class doesn’t have any public constructor and we get a Matcher object using pattern object matcher method that takes the input String as argument. We then use matches method that returns boolean result based on input String matches the regex pattern or not.
  3. PatternSyntaxException: PatternSyntaxException is thrown if the regular expression syntax is not correct.

Let’s have a look at Java Regex example program.

package com.journaldev.util;

import java.util.regex.*;

public class PatternExample {

	public static void main(String[] args) {
		Pattern pattern = Pattern.compile(".xx.");
		Matcher matcher = pattern.matcher("MxxY");
		System.out.println("Input String matches regex - "+matcher.matches());
		// bad regular expression
		pattern = Pattern.compile("*xx*");



When we run this java regex example program, we get below output.

Input String matches regex - true
Exception in thread "main" java.util.regex.PatternSyntaxException: Dangling meta character '*' near index 0
	at java.util.regex.Pattern.error(
	at java.util.regex.Pattern.sequence(
	at java.util.regex.Pattern.expr(
	at java.util.regex.Pattern.compile(
	at java.util.regex.Pattern.(
	at java.util.regex.Pattern.compile(
	at com.journaldev.util.PatternExample.main(

Since java regular expression revolves around String, String class has been extended in Java 1.4 to provide a matches method that does regex pattern matching. Internally it uses Pattern and Matcher java regex classes to do the processing but obviously it reduces the code lines.

Pattern class also contains matches method that takes regex and input String as argument and return boolean result after matching them.

So below code works fine for matching input String with a regular expression in Java.

String str = "bbb";
System.out.println("Using String matches method: "+str.matches(".bb"));
System.out.println("Using Pattern matches method: "+Pattern.matches(".bb", str));

So if your requirement is just to check if the input String matches with the pattern, you should save time and lines of code by using simple String matches method.

You should use Pattern and Matches classes only when you need to manipulate the input String or you need to reuse the pattern.

Note that the pattern defined by regex is applied on the String from left to right and once a source character is used in a match, it can’t be reused.

For example, regex “121” will match “31212142121” only twice as “_121____121”.

Regular Expression in Java – common matching symbols

Regular ExpressionDescriptionExample
.Matches any single character (“..”, “a%”) – true(“..”, “.a”) – true

(“..”, “a”) – false

^aaaMatches aaa regex at the beginning of the line  (“^a.c.”, “abcd”) – true

(“^a”, “ac”) – false

aaa$Matches regex aaa at the end of the line (“$”, “abcd”) – true(“a$”, “a”) – true

(“a$”, “aca”) – false

[abc]Can match any of the letter a, b or c. [] are known as character classes. (“^[abc]d.”, “ad9”) – true(“[ab].d$”, “bad”) – true

(“[ab]x”, “cx”) – false

[abc][12]Can match a, b or c followed by 1 or 2(“[ab][12].”, “a2#”) – true(“[ab]..[12]”, “acd2”) – true

(“[ab][12]”, “c2”) – false

[^abc]When ^ is the first character in [], it negates the pattern, matches anything except a, b or c(“[^ab][^12].”, “c3#”) – true(“[^ab]..[^12]”, “xcd3”) – true

(“[^ab][^12]”, “c2”) – false

[a-e1-8]Matches ranges between a to e or 1 to 8(“[a-e1-3].”, “d#”) – true(“[a-e1-3]”, “2”) – true

(“[a-e1-3]”, “f2”) – false

xx|yyMatches regex xx or yy(“x.|y”, “xa”) – true(“x.|y”, “y”) – true (“x.|y”, “yz”) – false

Java Regex Metacharacters

We have some meta characters in Java regex, it’s like shortcodes for common matching patterns.

Regular Expression Description
\dAny digits, short of [0-9]
\DAny non-digit, short for [^0-9]
\sAny whitespace character, short for [\t\n\x0B\f\r]
\SAny non-whitespace character, short for [^\s]
\wAny word character, short for [a-zA-Z_0-9]
\WAny non-word character, short for [^\w]
\bA word boundary
\BA non word boundary

There are two ways to use metacharacters as ordinary characters in regular expressions.

  1. Precede the metacharacter with a backslash (\).
  2. Keep metacharcter within \Q (which starts the quote) and \E (which ends it).

Regular Expression in Java – Quantifiers

Java Regex Quantifiers specify the number of occurrence of a character to match against.

Regular ExpressionDescription
x?x occurs once or not at all
X*X occurs zero or more times
X+X occurs one or more times
X{n}X occurs exactly n times
X{n,}X occurs n or more times
X{n,m}X occurs at least n times but not more than m times

Java Regex Quantifiers can be used with character classes and capturing groups also.

For example, [abc]+ means – a, b, or c – one or more times.

(abc)+ means the group “abc” one more more times. We will discuss about Capturing Group now.

Regular Expression in Java – Capturing Groups

Regular Expression in Java Capturing groups is used to treat multiple characters as a single unit. You can create a group using (). The portion of input String that matches the capturing group is saved into memory and can be recalled using Backreference.

You can use matcher.groupCount method to find out the number of capturing groups in a java regex pattern. For example, ((a)(bc)) contains 3 capturing groups – ((a)(bc)), (a) and (bc) .

You can use Backreference in the regular expression with a backslash (\) and then the number of the group to be recalled.

Capturing groups and Backreferences can be confusing, so let’s understand this with an example.

System.out.println(Pattern.matches("(\\w\\d)\\1", "a2a2")); //true
System.out.println(Pattern.matches("(\\w\\d)\\1", "a2b2")); //false
System.out.println(Pattern.matches("(AB)(B\\d)\\2\\1", "ABB2B2AB")); //true
System.out.println(Pattern.matches("(AB)(B\\d)\\2\\1", "ABB2B3AB")); //false

In the first example, at runtime first capturing group is (\w\d) which evaluates to “a2” when matched with the input String “a2a2” and saved in memory. So \1 is referring to “a2” and hence it returns true. Due to the same reason the second statement prints false.

Try to understand this scenario for statement 3 and 4 yourself. 🙂

Now we will look at some important methods of Pattern and Matcher classes.

  1. We can create a Pattern object with flags. For example Pattern.CASE_INSENSITIVE enables case insensitive matching.
  2. Pattern class also provides split(String) method that is similar to String class split() method.
  3. Pattern class toString() method returns the regular expression String from which this pattern was compiled.
  4. Matcher classes have start() and end() index methods that show precisely where the match was found in the input string.
  5. Matcher class also provides String manipulation methods replaceAll(String replacement) and replaceFirst(String replacement).

Let’s look at these java regex methods in a simple example program.

package com.journaldev.util;

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class RegexExamples {

	public static void main(String[] args) {
		// using pattern with flags
		Pattern pattern = Pattern.compile("ab", Pattern.CASE_INSENSITIVE);
		Matcher matcher = pattern.matcher("ABcabdAb");
		// using Matcher find(), group(), start() and end() methods
		while (matcher.find()) {
			System.out.println("Found the text \"" +
					+ "\" starting at " + matcher.start()
					+ " index and ending at index " + matcher.end());

		// using Pattern split() method
		pattern = Pattern.compile("\\W");
		String[] words = pattern.split("one@two#three:four$five");
		for (String s : words) {
			System.out.println("Split using Pattern.split(): " + s);

		// using Matcher.replaceFirst() and replaceAll() methods
		pattern = Pattern.compile("1*2");
		matcher = pattern.matcher("11234512678");
		System.out.println("Using replaceAll: " + matcher.replaceAll("_"));
		System.out.println("Using replaceFirst: " + matcher.replaceFirst("_"));


The output of the above java regex example program is.

Found the text "AB" starting at 0 index and ending at index 2
Found the text "ab" starting at 3 index and ending at index 5
Found the text "Ab" starting at 6 index and ending at index 8
Split using Pattern.split(): one
Split using Pattern.split(): two
Split using Pattern.split(): three
Split using Pattern.split(): four
Split using Pattern.split(): five
Using replaceAll: _345_678
Using replaceFirst: _34512678

That’s all for Regular expressions in Java. Java Regex seems hard at first, but if you work with them for some time, it’s easy to learn and use.

You can checkout complete code and more regular expressions examples from our GitHub Repository.


  1. Shaheed says:

    sorry number sequence should not be more than 2.

  2. Shaheed says:

    This tutorial is very helpful. I have one question how to represent a regex of allowing alphanumeric but number sequence should not be more than 3.
    Ex: Bas12 -> valid
    Bas123ba-> Invalid

  3. jb says:


    May I know how to change the string value e.g ‘1000’ to ‘$1,000.00’ or ‘1000%’ or ‘$100’ using regular expression?

    1. Mayank says:

      use currencyinstance from NumberFormat, will be easy to convert in any respective country currency.

  4. Radhika Patel says:

    Your all blogs regarding Java are to the point and with very good exceptional cases. I would happy to buy if you will publish java book …
    or pdf version of your blogs something. with Index and in order for new learners.

  5. Ruby says:

    I want to select the files of type xlsx and containing numbers 0-3 in there names.For example inp1.xlsx, inp2.xlsx ,etc.
    Can anyone tell me what RE I should have to write?

    1. MAHESH says:


    2. Mayank says:

      [\\w]+\\.(xlsx)$ , replace \\w
      [\\w] will include _ as well. so please follow below :-

      with [A-Za-z] if only alphabets allowed.
      with [A-Za-z0-9]if only alphanumeric allowed

  6. Ram says:

    I understood all except the below statements. Could someone please explain these?

    System.out.println(Pattern.matches(“(\\w\\d)\\1”, “a2a2”)); //true
    System.out.println(Pattern.matches(“(\\w\\d)\\1”, “a2b2”)); //false
    System.out.println(Pattern.matches(“(AB)(B\\d)\\2\\1”, “ABB2B2AB”)); //true
    System.out.println(Pattern.matches(“(AB)(B\\d)\\2\\1”, “ABB2B3AB”)); //false

  7. Rupesh says:

    How to verify that enter amount is in Indian currency format
    Suppose: User entered amount like
    if user enter any above input then it should be valid.

    if user entered
    111,111,111.00 or other country currency format then it should be invalid
    how write regex for it.

    1. Syed says:

      public static boolean isIndian(String amount) {
      String regex;
      if(amount.length()<=6) //checking thousands
      regex = "(([\\d]{1,3})\\.(..)$";
      else if(amount.length()<=9) //checking lakhs
      regex = "([\\d]{1,2})\\,([\\d]{1,3})\\.(..)$";
      else if(amount.length()<=12) //checking crores
      regex = "([\\d]{1,2})\\,([\\d]{1,2})\\,([\\d]{1,3})\\.(..)$";
      else //checking arabs
      regex = "([\\d]{1,2})\\,([\\d]{1,2})\\,([\\d]{1,2})\\,([\\d]{1,3})\\.(..)$";
      return Pattern.matches(regex, amount);

  8. Tyler says:

    Hi everyone, I am new to Java. I need to generate a random regular expression. Then the user-entered string will be checked against the randomly generated regular expression. This is a backward process of what is normally done. What would be the best way to generate a random regex? A sample code and an overview of steps would be very useful. Thanks a lot. – a Java beginner

  9. LR says:

    How can I use boolean operator to search for two words? If I enter – It AND Master in netbean’s command line it should find these two words in file and return the urllist where these two words are found in the file.

    1. Pankaj says:

      I didn’t understood what you meant. Care to explain in detail with some example?

  10. rohit says:

    hi all

    please tell me how we can add optional fields in our particular format. for eg. my number may or may not contain ‘-‘.

    1. Josenaldo says:

      555,555 = true
      123456,12345 = false
      -1,2 = true
      1,2 = true

      You can just repeat your regex including the “|” operator.

    2. Josenaldo says:

      Absolutely loved your explanation, bro, thank you so much!

  11. arjun says:

    (“^a”, “ac”) – returs true

    1. vino says:

      @argun , It returns true only because your patterns begins with “a” . This symbol “^” it indicates the begining, If you put “^” this in square bracket,for ex : [^a] it returns false when u compile with “ac” but if you use ^a like this it doesn’t indicate as negotion,it indicates only begining only

  12. Shreyansh Khandelwal says:

    HI, my input should contain only one backslash not more than that. How Should i do it ?

  13. Abhinav says:

    Grep a word using java regular expression:

    Str=”I am going to buy this pc @600.5$, can you let me know the deal”;

    Now I need to get the price of the quote using Java regular expression, can you please help me.

  14. Subrangshu says:

    How can I parse a String like
    String text = ” 1 (( NP ”
    using Regex. Can you please tell me a pattern which can match the above text. Also I want to extract each word out of the above text and save it separately.

  15. Cho Thet says:

    I want to parse onlu $x using parrern matching. But my problem is that it is parsing not only $x but also $xaaa. How to solve it?

  16. Ankita says:

    How to set validations for Email using Regular Expression wild card characters.

  17. kumaresan says:

    On example (“[a-e1-3]“, “f2″) – false
    The result is true.

    1. Sri says:

      It is false only. because ‘f’ is not in the range of a-e

  18. hari says:


    i need to add some text in the beginning of the line.

    for example notepad contain following text:
    Regular Expression By Pankaj, on\
    November 11th, 2012 In the last post,
    I explained about java regular expression in detail with some examples

    here i will search for a string suppose that string is “Pankaj”. now its in 2nd line to i want to add some text in the beginning of 2nd line

    Output should be :

    Extra Text Regular Expression By Pankaj,

    Could you please suggest me any way to get it done


  19. geeja says:

    is there any way i can extract only the
    execve and brk.
    execve(“/bin/ls”, [“ls”], [/* 38 vars */]) = 0
    brk(0) = 0x1e4d000

  20. veerender says:

    I need a help to write a regular experssion for data that is in brackets.. example (test123) or (187NY)..

    () is common.. please help

    1. Pankaj says:

      Pattern.matches(“\\(\\w+\\)”, “(test123)”);

      Pattern.matches(“\\(\\w+\\)”, “(187NY)”);

      Both returns TRUE.

  21. Herbert says:

    Hello Pankaj, very helpful, thanks. I’d like to find a pattern for:
    Match at least one character “No Whitespace and no double underscores (__)”.
    I.e. single underscores (_) are allowed.
    It should be not so difficult, but I cannot figure it out, Can you help me?

  22. JAY says:


  23. Challa Rama Rao says:

    It is very useful for me as I am working on some projects where I needed validations, Thank You very much Pankaj

    1. Pankaj says:

      Glad it helped you.

  24. Mohan says:

    very helpfull, thanx sir

  25. hassan shahzad aheer says:

    thank you sir it’s a very help tutorial for me thanks alot.

Comments are closed.

Generic selectors
Exact matches only
Search in title
Search in content