iconv_strpos
(PHP 5, PHP 7, PHP 8)
iconv_strpos — Повертає позицію першого входження підрядка
Опис
iconv_strpos( string $haystack, string $needle, int $offset = 0, ?string $encoding = null): int|false
Повертає позицію першого входження підрядка needle
в рядку haystack
В отличие отstrpos() iconv_strpos() повертає зміщення перед рядком у символах, а не в байтах. Кількість символів трактується залежно від вказаної параметром encoding
кодування.
Список параметрів
haystack
Рядок, в якому проводиться пошук.
needle
Шуканий підрядок.
offset
Необов'язковий параметр offset
дозволяє вказати, з якого символу рядка починати пошук. Якщо вказано негативне значення, зсув буде відлічуватися з кінця рядка.
encoding
Якщо параметр encoding
не вказано, то мається на увазі, що string
має кодування iconv.internal_encoding
Якщо haystack
илиneedle
не є рядками, вони будуть перетворені на рядок та застосовані як код символу.
Значення, що повертаються
Повертає номер позиції першого входження рядка needle
вhaystack
Якщо рядок needle
не найдена,iconv_strpos() повертає false
Увага
Ця функція може повертати як логічне значення **false
**так і значення не типу boolean, яке наводиться до false
. За більш детальною інформацією зверніться до розділу Логічний типИспользуйтеоператор === для перевірки значення, яке повертається цією функцією.
список змін
Версия | Опис |
---|---|
8.0.0 | encoding тепер допускає значення null. |
7.1.0 | Підтримка негативних значень offset |
Дивіться також
- strpos() - Повертає позицію першого входження підрядка
- iconv_strrpos() - Повертає позицію останнього входження підрядка
- mb_strpos() - Шукає позицію першого входження підрядка у рядок