Метод firstMatch

Метод firstMatch класса RegExp ищет первое совпадение регулярного выражения в строке. В параметр метода мы передаем строку, в которой нужно выполнить поиск. Метод возвращает объект RegExpMatch с информацией о найденном совпадении или null, если совпадений не найдено.

Синтаксис

RegExp(pattern).firstMatch(str)

Пример

Давайте найдем первое совпадение с шаблоном [0-9]+ в строке:

void main()
{
	RegExp regExp = RegExp(r'[0-9]+');
	RegExpMatch? res = regExp.firstMatch('abc123def456');
	
	print(res);
}

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

"123"

Пример

Давайте выведем найденное совпадение и его позицию в строке:

void main()
{
	RegExp regExp = RegExp(r'[a-z]+');
	RegExpMatch? res = regExp.firstMatch('123abcde456');
	
	if (res != null) {
		print(res.group(0));
		print(res.start);
		print(res.end);
	}
}

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

"abcde"
3
8

Пример

Давайте проверим, что метод возвращает, когда совпадений в строке нет:

void main()
{
	RegExp regExp = RegExp(r'[0-9]+');
	RegExpMatch? res = regExp.firstMatch('abcde');
	
	print(res);
}

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

null

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

метод allMatches,
который возвращает все совпадения
метод hasMatch,
который проверяет наличие совпадения
класс RegExp,
который представляет регулярное выражение
свойство pattern,
которое возвращает шаблон регулярного выражения