Метод equalsTo

Метод equalsTo класса UnicodeString проверяет, равна ли текущая строка переданной строке. Первым параметром передаётся строка для сравнения. Вторым необязательным параметром можно передать булево значение, которое включает сравнение без учёта регистра. Метод возвращает true, если строки совпадают, и false в противном случае.

Важно понимать, что сравнение происходит с учётом регистра по умолчанию. Если нужно игнорировать регистр, передайте вторым параметром true. Также метод корректно работает с многобайтовыми символами Unicode, в отличие от обычного сравнения строк в PHP.

Синтаксис

public function equalsTo(AbstractString $string, bool $ignoreCase = false): bool

Пример

Давайте создадим объект UnicodeString и сравним его с другой строкой:

<?php
	use Symfony\Component\String\UnicodeString;

	$str = new UnicodeString('abcde');
	$res = $str->equalsTo('abcde');

	var_dump($res);
?>

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

true

Пример

Давайте сравним строки с разным регистром:

<?php
	use Symfony\Component\String\UnicodeString;

	$str = new UnicodeString('abcde');
	$res = $str->equalsTo('ABCDE');

	var_dump($res);
?>

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

false

Пример

Давайте включим игнорирование регистра при сравнении:

<?php
	use Symfony\Component\String\UnicodeString;

	$str = new UnicodeString('abcde');
	$res = $str->equalsTo('ABCDE', true);

	var_dump($res);
?>

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

true

Пример

Давайте сравним строки с Unicode-символами:

<?php
	use Symfony\Component\String\UnicodeString;

	$str = new UnicodeString('привет');
	$res = $str->equalsTo('привет');

	var_dump($res);
?>

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

true

Пример

Давайте проверим, что строки с разным количеством символов не равны:

<?php
	use Symfony\Component\String\UnicodeString;

	$str = new UnicodeString('abcde');
	$res = $str->equalsTo('abc');

	var_dump($res);
?>

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

false

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

класс UnicodeString,
который представляет Unicode-строку
метод contains,
который проверяет наличие подстроки
метод startsWith,
который проверяет начало строки
метод endsWith,
который проверяет конец строки