substr_compare - Бинарно-безопасное сравнение 2 строк со смещением, с учетом или без учета регистра
Вернуться к: Обработка строк
substr_compare
(PHP 5)
substr_compare — Бинарно-безопасное сравнение 2 строк со смещением, с учетом или без учета регистра
Описание
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, substr_compare() выводит предупреждение и возвращает FALSE.
Список изменений
| Версия | Описание |
|---|---|
| 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); // предупреждение
?>
Вернуться к: Обработка строк