Метод matches

Метод matches проверяет, соответствует ли вся строка заданному регулярному выражению. Метод возвращает true, если строка полностью совпадает с шаблоном, и false в противном случае. Важно понимать, что проверка идёт от начала до конца строки целиком, а не поиск подстроки. В единственный параметр мы передаём регулярное выражение в виде строки.

Синтаксис

str.matches(regex)

Пример

Давайте проверим, состоит ли строка только из цифр:

public class Main
{
	public static void main(String[] args)
	{
		String str = "12345";
		System.out.println(str.matches("\\d+"));
	}
}

Результат выполнения кода:

true

Пример

Давайте проверим строку, которая не соответствует шаблону:

public class Main
{
	public static void main(String[] args)
	{
		String str = "abcde";
		System.out.println(str.matches("\\d+"));
	}
}

Результат выполнения кода:

false

Пример

Давайте проверим, начинается ли строка с буквы и состоит ли далее только из букв:

public class Main
{
	public static void main(String[] args)
	{
		String str = "abcde";
		System.out.println(str.matches("[a-z]+"));
	}
}

Результат выполнения кода:

true

Пример

Давайте проверим, что строка целиком соответствует шаблону, а не содержит его часть:

public class Main
{
	public static void main(String[] args)
	{
		String str = "abcde12345";
		System.out.println(str.matches("[a-z]+"));
	}
}

Результат выполнения кода:

false

Смотрите также

метод contains,
который проверяет наличие подстроки
метод replaceAll,
который заменяет все совпадения с регулярным выражением
метод split,
который разбивает строку по регулярному выражению
метод equals,
который сравнивает строки на равенство