Метод contains

Метод contains класса Str проверяет, содержит ли строка заданную подстроку или одну из переданных подстрок. Метод возвращает булево значение true, если искомая подстрока найдена, и false в противном случае. По умолчанию метод чувствителен к регистру символов.

В качестве первого параметра передаётся строка для поиска, вторым параметром - искомая подстрока или массив подстрок. Если передан массив, метод вернёт true при нахождении хотя бы одной из подстрок.

Синтаксис

<?php
	use Illuminate\Support\Str;
	
	Str::contains($haystack, $needles);
?>

Пример

Проверим, содержит ли строка 'Laravel Framework' подстроку 'Laravel':

<?php
	use Illuminate\Support\Str;
	
	$res = Str::contains('Laravel Framework', 'Laravel');
	var_dump($res);
?>

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

"true"

Пример

Проверим чувствительность к регистру на примере строки 'Hello World':

<?php
	use Illuminate\Support\Str;
	
	$res = Str::contains('Hello World', 'hello');
	var_dump($res);
?>

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

"false"

Пример

Проверим наличие одной из нескольких подстрок в строке 'Laravel is awesome':

<?php
	use Illuminate\Support\Str;
	
	$needles = ['Python', 'Java', 'PHP'];
	$res = Str::contains('Laravel is awesome', $needles);
	var_dump($res);
?>

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

"false"

Пример

Проверим наличие подстроки в переменной с помощью метода contains:

<?php
	use Illuminate\Support\Str;
	
	$text = 'The quick brown fox jumps over the lazy dog';
	$res = Str::contains($text, 'fox');
	
	if ($res) {
		echo 'Substring found';
	}
?>

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

"Substring found"

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

метод startsWith,
который проверяет, начинается ли строка с указанной подстроки
метод endsWith,
который проверяет, заканчивается ли строка на указанную подстроку
метод is,
который проверяет строку на соответствие заданному шаблону
метод containsAll,
который проверяет наличие всех переданных подстрок