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

# strcmp

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

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

### Описание

function 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 для строки

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open