strpos
(PHP 4, PHP 5, PHP 7, PHP 8)
strpos — Повертає позицію першого входження підрядка
Опис
strpos(string $haystack, string $needle, int $offset = 0): int|false
Шукає позицію першого входження підрядка needle у рядок haystack
Список параметрів
haystack
Рядок, в якому проводиться пошук.
needle
Рядок для пошуку.
До PHP 8.0.0, если параметрneedle - не рядок, він перетворюється на ціле число і трактується як код символу. Ця поведінка застаріла з PHP 7.3.0 і покладатися на неї не рекомендується. Залежно від передбачуваної поведінки, параметр needle повинен бути або явно приведений до рядка, або повинен бути виконаний явний виклик функції chr()
offset
Якщо цей параметр вказано, пошук буде розпочато із зазначеної кількості символів з початку рядка. Якщо задано негативне значення, відлік позиції початку пошуку буде здійснено з кінця рядка.
Значення, що повертаються
Повертає позицію, в якій знаходиться рядок, що шукається, щодо початку рядка haystack (Незалежно від усунення (offset)). Також зверніть увагу, що позиція рядка відраховується від 0, а чи не від 1.
Повертає false, якщо рядок не знайдено.
Увага
Ця функція може повертати як логічне значення **false**так і значення не типу boolean, яке наводиться до false. За більш детальною інформацією зверніться до розділу Логічний типИспользуйтеоператор === для перевірки значення, яке повертається цією функцією.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | Параметрneedle тепер допускає порожній рядок. |
| 8.0.0 | Передача цілого числа (int) needleбільше не підтримується. |
| 7.3.0 | Передача цілого числа (int) needle оголошено застарілою. |
| 7.1.0 | Додано підтримку негативних значень offset |
Приклади
Приклад #1 Использование===
Приклад #2 Використання !==
Приклад #3 Використання усунення
Примітки
Зауваження: Ця функція безпечна для обробки даних у двійковій формі.
Дивіться також
- stripos() - Повертає позицію першого входження підрядка без урахування регістру
- str_contains() - Визначає, чи містить рядок заданий підрядок
- str_ends_with() - Перевіряє, чи закінчується рядок заданим підрядком
- str_starts_with() - Перевіряє, чи починається рядок із заданого підрядка
- strrpos() - Повертає позицію останнього входження підрядка у рядку
- strripos() - Повертає позицію останнього входження підрядка без урахування регістру
- strstr() - Знаходить перше входження підрядка
- strpbrk() - Шукає у рядку будь-який символ із заданого набору
- substr() - Повертає підрядок
- preg_match() - Виконує перевірку на відповідність регулярному виразу