stristr
(PHP 4, PHP 5, PHP 7, PHP 8)
stristr - Реєстронезалежний варіант функції strstr()
Опис
stristr(string $haystack, string $needle, bool $before_needle = false): string|false
Повертає весь рядок haystack починаючи з першого входження needle включно.
Список параметрів
haystack
Рядок, в якому проводиться пошук
needle
Рядок для пошуку.
До PHP 8.0.0, если параметрneedle - не рядок, він перетворюється на ціле число і трактується як код символу. Ця поведінка застаріла з PHP 7.3.0 і покладатися на неї не рекомендується. Залежно від передбачуваної поведінки, параметр needle повинен бути або явно приведений до рядка, або повинен бути виконаний явний виклик функції chr()
before_needle
Если установлен в**true** stristr() повертає частину рядка haystackдо первого вхожденияneedle (Не включаючи needle).
needleиhaystack обробляються без урахування регістру.
Значення, що повертаються
Повертає зазначений підрядок. Якщо підрядок needle не знайдено, повертається false
список змін
| Версия | Опис |
|---|---|
| 8.2.0 | Перетворення регістру більше не залежить від локалі, встановленої за допомогою функції setlocale(). . Буде перетворено лише символи ASCII. Байти не ASCII-кодування будуть порівнюватися за значенням байта. |
| 8.0.0 | Параметрneedle тепер допускає порожній рядок. |
| 8.0.0 | Передача цілого числа (int) needleбільше не підтримується. |
| 7.3.0 | Передача цілого числа (int) needle оголошено застарілою. |
Приклади
Приклад #1 Приклад використання stristr()****
Приклад #2 Перевірка на входження рядка
Приклад #3 Використання не рядка у пошуку
Примітки
Зауваження: Ця функція безпечна для обробки даних у двійковій формі.
Дивіться також
- strstr() - Знаходить перше входження підрядка
- strrchr() - Знаходить останнє входження символу у рядку
- stripos() - Повертає позицію першого входження підрядка без урахування регістру
- strpbrk() - Шукає у рядку будь-який символ із заданого набору
- preg_match() - Виконує перевірку на відповідність регулярному виразу