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() - Поиск позиции первого вхождения одной строки в другую