Метод matchAsPrefix

Метод matchAsPrefix класса Pattern ищет совпадение с шаблоном в начале указанной строки. Первым параметром метод принимает строку, в которой выполняется поиск. Вторым необязательным параметром передается начальный индекс, с которого начинается поиск. Метод возвращает объект Match, если совпадение найдено, или null, если совпадений нет.

Класс Pattern является базовым для регулярных выражений RegExp, поэтому метод доступен и для них.

Синтаксис

pattern.matchAsPrefix(string, [start])

Пример

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

void main()
{
	Pattern pattern = RegExp('abc');
	Match? res = pattern.matchAsPrefix('abcde');
	print(res);
}

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

"abc"

Пример

Давайте получим позицию найденного совпадения через свойство start:

void main()
{
	Pattern pattern = RegExp('abc');
	Match? res = pattern.matchAsPrefix('abcde');
	print(res?.start);
}

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

0

Пример

Давайте проверим строку, которая не начинается с заданного шаблона. В этом случае метод вернет null:

void main()
{
	Pattern pattern = RegExp('abc');
	Match? res = pattern.matchAsPrefix('12345');
	print(res);
}

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

null

Пример

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

void main()
{
	Pattern pattern = RegExp('abc');
	Match? res = pattern.matchAsPrefix('12abcde', 2);
	print(res);
}

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

"abc"

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

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