Метод replaceFirst

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

Синтаксис

str.replaceFirst(regex, replacement)

Пример

Давайте заменим первое вхождение буквы "a" на "1":

public class Main
{
	public static void main(String[] args)
	{
		String str = "abcde";
		String res = str.replaceFirst("a", "1");
		System.out.println(res);
	}
}

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

"1bcde"

Пример

Давайте заменим первое вхождение цифры с помощью регулярного выражения "\\d" на "x":

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

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

"x2345"

Пример

Давайте заменим первое вхождение последовательности букв с помощью регулярного выражения "[a-z]+" на "!":

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

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

"!12345"

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

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