Метод matchAsPrefix

Метод matchAsPrefix класса String проверяет, совпадает ли начало текущей строки с заданным шаблоном Pattern. Если совпадение найдено, метод возвращает объект Match, содержащий информацию о найденном совпадении. Если совпадения нет - возвращается null. Первым параметром метод принимает шаблон Pattern, вторым - необязательный начальный индекс start, с которого начинается поиск (по умолчанию равен нулю). Важно понимать: метод проверяет совпадение именно с началом строки (или с позиции start), а не в любом месте строки.

Синтаксис

str.matchAsPrefix(pattern, [start])

Пример

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

void main()
{
	String str = 'abcde';
	Match? res = str.matchAsPrefix('abc');
	print(res);
}

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

Instance of 'Match'

Пример

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

void main()
{
	String str = 'abcde';
	Match? res = str.matchAsPrefix('xyz');
	print(res);
}

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

null

Пример

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

void main()
{
	String str = 'abcde';
	Match? res = str.matchAsPrefix('cde', 2);
	print(res);
}

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

Instance of 'Match'

Пример

Давайте извлечём найденное совпадение через свойство group(0) и выведем его на экран:

void main()
{
	String str = 'abcde';
	Match? res = str.matchAsPrefix('abc');
	print(res?.group(0));
}

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

"abc"

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

метод startsWith,
который проверяет начало строки
метод contains,
который проверяет наличие подстроки
метод allMatches,
который возвращает все совпадения
метод indexOf,
который возвращает позицию подстроки