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.0encoding тепер допускає значення null.
7.1.0Підтримка негативних значень offset

Дивіться також

  • strpos() - Повертає позицію першого входження підрядка
  • iconv_strrpos() - Повертає позицію останнього входження підрядка
  • mb_strpos() - Шукає позицію першого входження підрядка у рядок