strncmp

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

strncmp — Сравнивает первые n символов строк в бинарно безопасном режиме

Описание

strncmp(string $string1, string $string2, int $length): int

Функция работает аналогично функции strcmp(), за исключением того, что возможно указать максимальное количество символов для сравнения в каждой строке.

Функция учитывает регистр символов.

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

string1

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

string2

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

length

Количество символов, которое требуется сравнить.

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

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

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

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

Примеры

Пример #1 Пример сравнения первых символов строк в бинарно безопасном режиме функцией strncmp()

<?php

$var1 = 'Hello John';
$var2 = 'Hello Doe';

if (strncmp($var1, $var2, 5) === 0) {
echo 'Первые 5 символов переменных $var1 и $var2 равны при сравнении строк с учётом регистра';
}

?>

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

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