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