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, так и нелогическое значение, которое приводится к false. Прочитайте раздел «Логический тип», чтобы получить дополнительную информацию. Используйте оператор === для проверки значения, которое возвращает функция.

Список изменений

Версия	Описание
8.0.0	`encoding` теперь допускает значение null.
7.1.0	Поддержка отрицательных значений `offset`.

Смотрите также

strpos() - Возвращает позицию первого вхождения подстроки
iconv_strrpos() - Возвращает позицию последнего вхождения подстроки
mb_strpos() - Ищет позицию первого вхождения подстроки в строку

add a note

User Contributed Notes

There are no user contributed notes for this page.