strncmp

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

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

Описание

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

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

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

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

string1

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

string2

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

length

Количество символов, которые сравнивает функция.

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

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

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

Версия Описание
8.2.0 Теперь функция возвращает -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() - Возвращает подстроку