ConFoo 2025

stristr

(PHP 4, PHP 5, PHP 7, PHP 8)

stristrРегистронезависимый вариант функции strstr()

Описание

stristr(string $haystack, string $needle, bool $before_needle = false): string|false

Функция возвращает строку haystack с первого вхождения подстроки needle включительно.

Список параметров

haystack

Строка, в которой выполняется поиск.

needle

Строка, которую требуется найти.

До PHP 8.0.0, если параметр needle — не строка, он преобразовывается в целое число и трактуется как код символа. Это поведение устарело с PHP 7.3.0 и полагаться на него крайне не рекомендуется. В зависимости от предполагаемого поведения, параметр needle должен быть либо явно приведён к строке, либо должен быть выполнен явный вызов функции chr().

before_needle

Если для параметра установили значение true, функция stristr() возвращает часть «стога» haystack, которая идёт перед первым вхождением «иголки» needle, не включая «иголку».

Параметры needle и haystack обрабатываются без учёта регистра.

Возвращаемые значения

Функция возвращает совпавшую подстроку. Если функция не нашла подстроку needle, возвращается false.

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

Версия Описание
8.2.0 Приведение к единому регистру больше не зависит от региональных настроек, которые установили функцией setlocale(). Преобразовываются только символы кодировки ASCII. Байты, которые не относятся к кодировке ASCII, сравнятся по значению байта.
8.0.0 Параметр needle теперь разрешает пустую строку.
8.0.0 Передача целого числа (int) в параметр needle больше не поддерживается.
7.3.0 Передачу целого числа (int) в параметр needle объявили устаревшей.

Примеры

Пример #1 Пример использования функции stristr()

<?php

$email
= 'USER@EXAMPLE.com';
echo
stristr($email, 'e'); // Выводит: ER@EXAMPLE.com
echo stristr($email, 'e', true); // Выводит: US

?>

Пример #2 Проверка на вхождение строки

<?php

$string
= 'Hello World!';
if (
stristr($string, 'earth') === FALSE) {
echo
'Функция не нашла в строке подстроку «earth»';
}
// Выводит: Функция не нашла в строке подстроку «earth»

?>

Пример #3 Пример работы функции с нестроковой «иглой»

<?php

$string
= 'APPLE';
echo
stristr($string, 97); // 97 — кодовая точка Юникода для прописной буквы «a»
// Выводит: APPLE

?>

Примечания

Замечание: Функция безопасна для обработки данных в двоичной форме.

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

  • strstr() - Находит первое вхождение подстроки
  • strrchr() - Находит последнее вхождение символа в строке
  • stripos() - Возвращает позицию первого вхождения подстроки без учёта регистра
  • strpbrk() - Ищет в строке любой символ из набора
  • preg_match() - Выполняет проверку на соответствие регулярному выражению

Добавить

Примечания пользователей 5 notes

up
17
dpatton.at.confluence.org
22 years ago
There was a change in PHP 4.2.3 that can cause a warning message
to be generated when using stristr(), even though no message was
generated in older versions of PHP.

The following will generate a warning message in 4.0.6 and 4.2.3:
stristr("haystack", "");
OR
$needle = ""; stristr("haystack", $needle);

This will _not_ generate an "Empty Delimiter" warning message in
4.0.6, but _will_ in 4.2.3:
unset($needle); stristr("haystack", $needle);

Here's a URL that documents what was changed:
http://groups.google.ca/groups?selm=cvshholzgra1031224321%40cvsserver
up
7
giz at gbdesign dot net
17 years ago
Just been caught out by stristr trying to converting the needle from an Int to an ASCII value.

Got round this by casting the value to a string.

<?php
if( !stristr( $file, (string) $myCustomer->getCustomerID() ) ) {
// Permission denied
}
?>
up
3
Techdeck at Techdeck dot org
22 years ago
An example for the stristr() function:

<?php
$a
= "I like php";
if (
stristr("$a", "LikE PhP")) {
print (
"According to \$a, you like PHP.");
}
?>

It will look in $a for "like php" (NOT case sensetive. though, strstr() is case-sensetive).

For the ones of you who uses linux.. It is similiar to the "grep" command.
Actually.. "grep -i".
up
-1
notepad at codewalkers dot com
19 years ago
<?php

function stristr_reverse($haystack, $needle) {
$pos = stripos($haystack, $needle) + strlen($needle);
return
substr($haystack, 0, $pos);
}
$email = 'USER@EXAMPLE.com';
echo
stristr_reverse($email, 'er');
// outputs USER

?>
up
-3
jukka
10 years ago
I think there is a bug in php 5.3 in stristr with uppercase Ä containing other character

http://pastebin.com/5bP6uztY

if you search only with täry it works, but as soon as the word is tärylä it does not. TÄRYL works fine
To Top