substr_compare
(PHP 5, PHP 7, PHP 8)
substr_compare - Бінарно-безпечне порівняння 2 рядків зі зміщенням, з урахуванням або без обліку регістру
Опис
substr_compare( string $haystack, string $needle, int $offset, ?int $length = null, bool $case_insensitive = false): int
**substr_compare()**сравнивает строкуhaystack (починаючи з позиції offset) з рядком needleВ сравнении участвуют максимумlength символів.
Список параметрів
haystack
Основний порівнюваний рядок.
needle
Наступний порівнюваний рядок.
offset
Стартова позиція порівняння. Якщо негативна, позначає зміщення з кінця рядка.
length
Довжина порівняння. За замовчуванням використовується максимальна з довжин needleиhaystackминусoffset
case_insensitive
Якщо case_insensitiveимеет значение**true**, Порівняння виконується без урахування регістру.
Значення, що повертаються
Повертає -1, якщо string1меньшеstring2 , якщо string1большеstring2, и якщо рядки рівні. Якщо offset більше (до PHP 7.2.18, 7.3.5) або дорівнює довжині haystackилиlength переданий і менше 0, substr_compare() виводить попередження та повертає false
список змін
| Версия | Опис |
|---|---|
| 8.2.0 | Функція тепер повертає -1или ; раніше вона повертала негативне чи позитивне число. |
| 8.0.0 | length тепер допускає значення null. |
| 7.2.18, 7.3.5 | offset тепер може бути рівним haystack |
Приклади
Приклад #1 Приклад використання substr_compare()****
Дивіться також
- strncmp() - Бінарно-безпечне порівняння перших n символів рядків