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

down

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

down

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

}

?>

down

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".

down

-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



?>

down

-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

＋Добавить