strcasecmp

(PHP 4, PHP 5, PHP 7, PHP 8)

strcasecmpСравнивает строки без учёта регистра в бинарно безопасном режиме

Описание

strcasecmp(string $string1, string $string2): int

Функция сравнивает строки без учёта регистра в бинарно безопасном режиме — как поток байтов. Сравнение не учитывает региональные настройки; функция сравнивает без учёта регистра только буквы кодировки ASCII.

Список параметров

string1

Первая строка.

string2

Вторая строка.

Возвращаемые значения

Функция возвращает значение меньше 0, если строка string1 меньше строки string2; значение больше 0, если строка string1 больше строки string2, и 0, если строки равны. Из значения возврата невозможно надёжно вывести конкретное значение, кроме знака числа.

Список изменений

Версия Описание
8.2.0 Функция больше не гарантирует возврат разницы strlen($string1) - strlen($string2), когда длины строк не равны, но теперь вместо этого иногда возвращает -1 или 1.

Примеры

Пример #1 Пример сравнения строк функцией strcasecmp()

<?php

$var1
= "Hello";
$var2 = "hello";

if (
strcasecmp($var1, $var2) == 0) {
echo
'Перменная $var1 равна переменной $var2 при сравнении без учёта регистра';
}

?>

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

  • strcmp() - Сравнивает строки в бинарно-безопасном режиме: как последовательности байтов
  • preg_match() - Выполняет проверку на соответствие регулярному выражению
  • substr_compare() - Сравнивает две строки со смещения до заданного количества символов в бинарно безопасном режиме
  • strncasecmp() - Сравнивает первые n символов строк без учёта регистра в бинарно-безопасном режиме
  • stristr() - Регистронезависимый вариант функции strstr
  • substr() - Возвращает подстроку