iconv_strpos
(PHP 5, PHP 7)
iconv_strpos — Возвращает позицию первого вхождения подстроки
Описание
$haystack
, string $needle
, int $offset = 0
, string|null $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() - Поиск позиции первого вхождения одной строки в другую