substr_compare - Бинарно-безопасное сравнение 2 строк со смещением, с учетом или без учета регистра
Вернуться к: Обработка строк
substr_compare
(PHP 5, PHP 7)
substr_compare — Бинарно-безопасное сравнение 2 строк со смещением, с учетом или без учета регистра
Описание
$main_str
, string $str
, int $offset
[, int $length
[, bool $case_insensitivity
= false
]] )
substr_compare() сравнивает строку
main_str
(начиная с позиции
offset
) со строкой
str
. В сравнении участвуют максимум
length
символов.
Список параметров
-
main_str
-
Основная сравниваемая строка.
-
str
-
Следующая сравниваемая строка.
-
offset
-
Стартовая позиция сравнения. Если отрицательна, то обозначает смещение с конца строки.
-
length
-
Длина сравнения. По умолчанию используется максимальная из длин
str
иmain_str
минусoffset
. -
case_insensitivity
-
Если
case_sensitivity
имеет значениеTRUE
, сравнение выполняется с учетом регистра.
Возвращаемые значения
Возвращает отрицательное число, если строка
main_str
(начиная с символа
offset
) меньше, чем
str
; положительное число,
если она больше str
; 0 если строки равны.
Если offset
больше или равен длине
main_str
или length
передан
и меньше 1 (до версии PHP 5.6), substr_compare() выводит
предупреждение и возвращает FALSE
.
Список изменений
Версия | Описание |
---|---|
5.6.0 |
length теперь может быть равной 0.
|
5.1.0 |
Добавлена возможность использования отрицательных значений в offset .
|
Примеры
Пример #1 Пример использования substr_compare()
<?php
echo substr_compare("abcde", "bc", 1, 2); // 0
echo substr_compare("abcde", "de", -2, 2); // 0
echo substr_compare("abcde", "bcg", 1, 2); // 0
echo substr_compare("abcde", "BC", 1, 2, true); // 0
echo substr_compare("abcde", "bc", 1, 3); // 1
echo substr_compare("abcde", "cd", 1, 2); // -1
echo substr_compare("abcde", "abc", 5, 1); // предупреждение
?>
Вернуться к: Обработка строк