Метод replaceFirst

Метод replaceFirst заменяет первое вхождение указанной подстроки или регулярного выражения на новую строку. Сама исходная строка при этом не изменяется - метод возвращает новую строку с произведенной заменой. В первый параметр мы передаем то, что нужно найти (подстроку или регулярное выражение), а во второй - строку, на которую нужно заменить найденное.

Синтаксис

str.replaceFirst(from, to)

Пример

Давайте заменим первое вхождение подстроки 'ab' на строку '12':

void main()
{
	String str = 'abcdeabcde';
	String res = str.replaceFirst('ab', '12');
	print(res);
}

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

"12cdeabcde"

Пример

Если искомая подстрока не найдена в строке, метод вернет исходную строку без изменений:

void main()
{
	String str = 'abcde';
	String res = str.replaceFirst('xy', '12');
	print(res);
}

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

"abcde"

Пример

В качестве первого параметра можно передать регулярное выражение. Давайте заменим первое вхождение любой цифры на символ '*':

void main()
{
	String str = '12345';
	String res = str.replaceFirst(RegExp(r'\d'), '*');
	print(res);
}

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

"*2345"

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

метод replaceAll,
который заменяет все вхождения подстроки
метод replaceFirstMapped,
который заменяет первое вхождение с помощью функции
метод replaceRange,
который заменяет диапазон символов
метод indexOf,
который возвращает позицию подстроки