strcmp

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

strcmpСравнивает строки в бинарно-безопасном режиме: как последовательности байтов

Описание

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

Обратите внимание, что при сравнении учитывается регистр символов. Для сравнения без учёта регистра смотрите функцию strcasecmp().

Обратите внимание, что при сравнении не учитывает локаль. Для сравнения с учётом локали смотрите функцию strcoll() или Collator::compare().

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

string1

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

string2

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

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

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

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

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

Примеры

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

<?php

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

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

?>

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

  • Полное сравнение строк
    • strcasecmp() - Сравнивает строки без учёта регистра в бинарно безопасном режиме
    • Collator::compare() - Сравнивает две строки Unicode
    • strcoll() - Сравнивает строки с учётом текущей локали
  • Частичное сравнение строк
    • substr_compare() - Сравнивает две строки со смещения до заданного количества символов в бинарно безопасном режиме
    • strncmp() - Сравнивает первые n символов строк в бинарно безопасном режиме
    • strstr() - Находит первое вхождение подстроки
  • Сравнение похожих/других строк
    • preg_match() - Выполняет проверку на соответствие регулярному выражению
    • levenshtein() - Вычисляет расстояние Левенштейна между двумя строками
    • metaphone() - Возвращает ключ metaphone для строки
    • similar_text() - Вычисляет степень похожести двух строк
    • soundex() - Возвращает ключ soundex для строки