stripos - Возвращает позицию первого вхождения подстроки без учета регистра
Вернуться к: Обработка строк
stripos
(PHP 5, PHP 7)
stripos — Возвращает позицию первого вхождения подстроки без учета регистра
Описание
Ищет позицию первого вхождения подстроки
needle
в строку haystack
.
В отличие от strpos(), эта функция не учитывает регистр символов.
Список параметров
-
haystack
-
Строка, в которой производится поиск.
-
needle
-
Заметьте, что
needle
может содержать строку из одного или более символов.Если
needle
не является строкой, он приводится к целому и трактуется как код символа. -
offset
-
Если этот параметр указан, то поиск будет начат с указанного количества символов с начала строки. В отличии от strrpos() и strripos() данный параметр не может быть отрицательным.
Возвращаемые значения
Возвращает позицию, в которой находится искомая строка, относительно
начала строки haystack
(независимо от смещения (offset).
Также обратите внимание на то, что позиция строки отсчитывается от 0, а не от 1.
Возвращает FALSE
, если искомая строка не найдена.
Эта функция
может возвращать как boolean FALSE
, так и не-boolean значение,
которое приводится к FALSE
. За более подробной информацией обратитесь к разделу
Булев тип. Используйте оператор === для проверки значения,
возвращаемого этой функцией.
Примеры
Пример #1 Пример использования stripos()
<?php
$findme = 'a';
$mystring1 = 'xyz';
$mystring2 = 'ABC';
$pos1 = stripos($mystring1, $findme);
$pos2 = stripos($mystring2, $findme);
// Конечно, 'a' не входит в 'xyz'
if ($pos1 === false) {
echo "Строка '$findme' не найдена в строке '$mystring1'";
}
// Заметьте, что используется ===. Использование == не даст верного
// результата, так как 'a' в нулевой позиции.
if ($pos2 !== false) {
echo "Нашел '$findme' в '$mystring2' в позиции $pos2";
}
?>
Примечания
Замечание: Эта функция безопасна для обработки данных в двоичной форме.
Смотрите также
- mb_stripos() - Поиск позиции первого вхождения одной строки в другую, нечувствителен к регистру
- strpos() - Возвращает позицию первого вхождения подстроки
- strrpos() - Возвращает позицию последнего вхождения подстроки в строке
- strripos() - Возвращает позицию последнего вхождения подстроки без учета регистра
- stristr() - Регистронезависимый вариант функции strstr
- substr() - Возвращает подстроку
- str_ireplace() - Регистронезависимый вариант функции str_replace
Вернуться к: Обработка строк