stristr

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

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

    Описание

    function 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 обрабатываются без учёта регистра.

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

    Функция возвращает часть входной строки. Функция возвращает значение false, если не находит подстроку needle.

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

    Версия Описание
    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'), PHP_EOL; // Выводит: ER@EXAMPLE.com
echo stristr($email, 'e', true), PHP_EOL; // Выводит: US

?>

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

    <?php

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

?>

    Примечания

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

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

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

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

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

    up
    17
    dpatton.at.confluence.org
    23 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
    18 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
    23 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
    21 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
    12 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