Метод replaceFirst

Метод Str::replaceFirst применяется для замены только первого вхождения определённой подстроки в строке. Это особенно полезно, когда требуется изменить только первое совпадение, оставляя остальные без изменений. Первым параметром передаётся искомая подстрока, вторым - строка для замены, третьим - исходная строка, в которой производится замена. Метод возвращает новую строку с выполненной заменой.

Синтаксис

<?php
	use Illuminate\Support\Str;
	
	Str::replaceFirst($search, $replace, $subject);
?>

Пример

Давайте заменим первое вхождение слова 'abc' на 'xyz' в строке:

<?php
	use Illuminate\Support\Str;
	
	$string = 'abc abc abc';
	$res = Str::replaceFirst('abc', 'xyz', $string);
	
	echo $res;
?>

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

"xyz abc abc"

Пример

Давайте заменим первое вхождение слова 'user' на 'admin' в строке:

<?php
	use Illuminate\Support\Str;
	
	$string = 'user and user';
	$res = Str::replaceFirst('user', 'admin', $string);
	
	echo $res;
?>

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

"admin and user"

Пример

Давайте заменим первое вхождение символа 'a' на 'b' в строке 'abcde':

<?php
	use Illuminate\Support\Str;
	
	$string = 'abcde';
	$res = Str::replaceFirst('a', 'b', $string);
	
	echo $res;
?>

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

"bbcde"

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

метод replaceLast,
который заменяет последнее вхождение подстроки
метод replace,
который заменяет все вхождения подстроки
метод remove,
который удаляет все вхождения подстроки
метод swap,
который выполняет множественную замену подстрок