Какая функция в php позволяет найти вхождение подстроки

stripos

Ищет позицию первого вхождения подстроки needle в строке haystack .

В отличие от strpos() , эта функция не учитывает регистр символов.

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

Строка, в которой производится поиск.

Строка для поиска.

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

Если этот параметр указан, то поиск будет начат с указанного количества символов с начала строки. Если задано отрицательное значение, отсчёт позиции начала поиска будет произведён с конца строки.

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

Возвращает позицию, в которой находится искомая строка, относительно начала строки haystack (независимо от смещения (offset)). Также обратите внимание на то, что позиция строки отсчитывается от 0, а не от 1.

Возвращает false , если искомая строка не найдена.

Внимание

Эта функция может возвращать как логическое значение false , так и значение не типа boolean, которое приводится к false . За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.

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

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

Примеры

Пример #1 Пример использования stripos()

$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() — Регистронезависимый поиск позиции первого вхождения одной строки в другую
• str_contains() — Определяет, содержит ли строка заданную подстроку
• str_ends_with() — Проверяет, заканчивается ли строка заданной подстрокой
• str_starts_with() — Проверяет, начинается ли строка с заданной подстроки
• strpos() — Возвращает позицию первого вхождения подстроки
• strrpos() — Возвращает позицию последнего вхождения подстроки в строке
• strripos() — Возвращает позицию последнего вхождения подстроки без учёта регистра
• stristr() — Регистронезависимый вариант функции strstr
• substr() — Возвращает подстроку
• str_ireplace() — Регистронезависимый вариант функции str_replace

strripos

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

В отличие от strrpos() , strripos() не учитывает регистр символов.

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

Строка, в которой производится поиск.

Строка для поиска.

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

Если равно или больше ноля, то поиск будет идти слева направо и, при этом, будут пропущены первые offset байт строки haystack .

Если меньше ноля, то поиск будет идти справа налево. При этом будут отброшены offset байт с конца haystack и найдено первое найденное вхождение needle .

Замечание:

Фактически это будет последнее вхождение needle без учёта offset последних байт.

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

Возвращает номер позиции последнего вхождения needle относительно начала строки haystack (независимо от направления поиска и смещения (offset)).

Замечание: Позиция в строке строки отсчитывается от 0, а не от 1.

Возвращает false , если искомая строка не найдена.

Внимание

Эта функция может возвращать как логическое значение false , так и значение не типа boolean, которое приводится к false . За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.

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

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

Примеры

Пример #1 Пример использования strripos()

$pos = strripos ( $haystack , $needle );

if ( $pos === false ) echo «К сожалению, ( $needle ) не найдена в ( $haystack )» ;
> else echo «Поздравляем!\n» ;
echo «Последнее вхождение ( $needle ) найдено в ( $haystack ) в позиции ( $pos )» ;
>
?>

Результат выполнения данного примера:

Поздравляем! Последнее вхождение (aB) найдено в (ababcd) в позиции (2)

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

• strpos() — Возвращает позицию первого вхождения подстроки
• stripos() — Возвращает позицию первого вхождения подстроки без учёта регистра
• strrpos() — Возвращает позицию последнего вхождения подстроки в строке
• strrchr() — Находит последнее вхождение символа в строке
• stristr() — Регистронезависимый вариант функции strstr
• substr() — Возвращает подстроку

User Contributed Notes 7 notes

16 years ago

Simple way to implement this function in PHP 4

if ( function_exists ( ‘strripos’ ) == false ) function strripos ( $haystack , $needle ) return strlen ( $haystack ) — strpos ( strrev ( $haystack ), $needle );
>
>

15 years ago

Suppose you just need a stripos function working backwards expecting that strripos does this job, you better use the following code of a custom function named strbipos:

function strbipos ( $haystack = «» , $needle = «» , $offset = 0 ) // Search backwards in $haystack for $needle starting from $offset and return the position found or false

$len = strlen ( $haystack );
$pos = stripos ( strrev ( $haystack ), strrev ( $needle ), $len — $offset — 1 );
return ( ( $pos === false ) ? false : $len — strlen ( $needle ) — $pos );
>

// Test
$body = «01234Xy7890XYz456xy90» ;
$str = «xY» ;
$len = strlen ( $body );
echo «TEST POSITIVE offset VALUES IN strbipos
» ;
for ( $i = 0 ; $i < $len ; $i ++) echo "Search in [ $body ] for [ $str ] starting from offset [ $i ]: [" . strbipos ( $body , $str , $i ) . "]
» ;
>
?>

Note that this function does exactly what it says and its results are different comparing to PHP 5 strripos function.

13 years ago

Generally speaking, linear searches are from start to end, not end to start — which makes sense from a human perspective. If you need to find strings in a string backwards, reverse your haystack and needle rather than manually chopping it up.

15 years ago

OK, I guess this will be the final function implementation for PHP 4.x versions ( my previous posts are invalid )

if(! function_exists ( «stripos» )) function stripos ( $str , $needle , $offset = 0 ) return strpos ( strtolower ( $str ), strtolower ( $needle ), $offset );
> /* endfunction stripos */
> /* endfunction exists stripos */

if(! function_exists ( «strripos» )) function strripos ( $haystack , $needle , $offset = 0 ) if( ! is_string ( $needle ) ) $needle = chr ( intval ( $needle ) );
if( $offset < 0 )$temp_cut = strrev ( substr ( $haystack , 0 , abs ( $offset ) ) );
>
else $temp_cut = strrev ( substr ( $haystack , 0 , max ( ( strlen ( $haystack ) — $offset ), 0 ) ) );
>
if( ( $found = stripos ( $temp_cut , strrev ( $needle ) ) ) === FALSE )return FALSE ;
$pos = ( strlen ( $haystack ) — ( $found + $offset + strlen ( $needle ) ) );
return $pos ;
> /* endfunction strripos */
> /* endfunction exists strripos */
?>

16 years ago

I think you shouldn’t underestimate the length of $needle in the search of THE FIRST POSITION of it’s last occurrence in the string. I improved the posted function, with added support for offset. I think this is an exact copy of the real function:

if(! function_exists ( «strripos» )) function strripos ( $haystack , $needle , $offset = 0 ) if( $offset < 0 )$temp_cut = strrev ( substr ( $haystack , 0 , abs ( $offset ) ) );
>
else $temp_cut = strrev ( substr ( $haystack , $offset ) );
>
$pos = strlen ( $haystack ) — ( strpos ( $temp_cut , strrev ( $needle )) + $offset + strlen ( $needle ));
if ( $pos == strlen ( $haystack )) < $pos = 0 ; >
return $pos ;
> /* endfunction strripos*/
> /* endfunction exists strripos*/
?>

16 years ago

Sorry, I made that last post a bit prematurely. One more thing wrong with the simple php4 version is that it breaks if the string is not found. It should actually look like this:

if ( function_exists ( ‘strripos’ ) == false ) function strripos ( $haystack , $needle ) $pos = strlen ( $haystack ) — strpos ( strrev ( $haystack ), strrev ( $needle ));
if ( $pos == strlen ( $haystack )) < $pos = 0 ; >
return $pos ;
>
>
?>

Note, we now check to see if the $needle was found, and if it isn’t, we return 0.

13 years ago

strripos() has very strange behaviour when you provide search position. For some reason it searches forward from the given position, instead of searching backward, that is more logical.

For example if you want to find instanse of $what, previous to the last, strripos($where, $what, $last_what_pos-1) will not wark as expected. It will return $last_what_pos again and again. And that has no sence at all.

To prevent this, I just used $prev_last_what_pos = strripos(substr($where,0,$last_what_pos), $what);

• Copyright © 2001-2023 The PHP Group
• My PHP.net
• Contact
• Other PHP.net sites
• Privacy policy

str_contains

Выполняет проверку с учётом регистра, указывающую, содержится ли needle в haystack .

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

Строка для поиска.

Подстрока для поиска в haystack .

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

Возвращает true , если needle содержится в haystack , false в противном случае.

Примеры

Пример #1 Пример использования пустой строки »

if ( str_contains ( ‘абв’ , » )) echo «Проверка существования пустой строки всегда возвращает true» ;
>
?>

Результат выполнения данного примера:

Проверка существования пустой строки всегда возвращает true

Пример #2 Демонстрация чувствительности к регистру

$string = ‘ленивая лиса перепрыгнула через забор’ ;

if ( str_contains ( $string , ‘ленивая’ )) echo «Строка ‘ленивая’ найдена в проверяемой строке\n» ;
>

if ( str_contains ( $string , ‘Ленивая’ )) echo ‘Строка «Ленивая» найдена в проверяемой строке’ ;
> else echo ‘»Ленивая» не найдена потому что регистр не совпадает’ ;
>

Результат выполнения данного примера:

Строка 'ленивая' найдена в проверяемой строке "Ленивая" не найдена потому что регистр не совпадает

Примечания

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

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

• str_ends_with() — Проверяет, заканчивается ли строка заданной подстрокой
• str_starts_with() — Проверяет, начинается ли строка с заданной подстроки
• stripos() — Возвращает позицию первого вхождения подстроки без учёта регистра
• strrpos() — Возвращает позицию последнего вхождения подстроки в строке
• strripos() — Возвращает позицию последнего вхождения подстроки без учёта регистра
• strstr() — Находит первое вхождение подстроки
• strpbrk() — Ищет в строке любой символ из заданного набора
• substr() — Возвращает подстроку
• preg_match() — Выполняет проверку на соответствие регулярному выражению

User Contributed Notes 9 notes

2 years ago

For earlier versions of PHP, you can polyfill the str_contains function using the following snippet:

// based on original work from the PHP Laravel framework
if (! function_exists ( ‘str_contains’ )) function str_contains ( $haystack , $needle ) return $needle !== » && mb_strpos ( $haystack , $needle ) !== false ;
>
>
?>

1 year ago

The polyfill that based on original work from the PHP Laravel framework had a different behavior;

when the $needle is `»»` or `null`:
php8’s will return `true`;
but, laravel’str_contains will return `false`;

when php8.1, null is deprecated, You can use `$needle ?: «»`;

3 months ago

A couple of functions for checking if a string contains any of the strings in an array, or all of the strings in an array:

function str_contains_any ( string $haystack , array $needles ): bool
return array_reduce ( $needles , fn( $a , $n ) => $a || str_contains ( $haystack , $n ), false );
>

function str_contains_all ( string $haystack , array $needles ): bool
return array_reduce ( $needles , fn( $a , $n ) => $a && str_contains ( $haystack , $n ), true );
>
?>

str_contains_all() will return true if $needles is an empty array. If you think that’s wrong, show me a string in $needles that DOESN’T appear in the $haystack, and then look up «vacuous truth».

(By swapping haystacks and needles in the body of these functions you can create versions that check if a needle appears in any/all of an array of haystacks.)

2 years ago

The code from «me at daz dot co dot uk» will not work if the word is
— at the start of the string
— at the end of the string
— at the end of a sentence (like «the ox.» or «is that an ox?»)
— in quotes
— and so on.

You should explode the string by whitespace, punctations, . and check if the resulting array contains your word OR try to test with a RegEx like this:
(^|[\s\W])+word($|[\s\W])+

Disclaimer: The RegEx may need some tweaks

2 months ago

This function doesn’t always produce the expected results if you have a needle that isn’t UTF-8 but are looking for it in a UTF-8 string. This won’t be a concern for most people, but if you are mixing old and new data, especially if reading data from a file, it could be an issue.

Here’s a «mb_*»-esque function that searches the string:

function mb_str_contains ( string $haystack , string $needle , $encoding = null ) return $needle === » || mb_substr_count ( $haystack , $needle , (empty( $encoding ) ? mb_internal_encoding () : $encoding )) > 0 ;
>
?>

I used mb_substr_count() instead of mb_strpos() because mb_strpos() will still match partial characters as it’s doing a binary search.

We can compare str_contains to the above suggested function:

// Some Unicode Kanji (漢字はユニコード)
$string = hex2bin ( ‘e6bca2e5ad97e381afe383a6e3838be382b3e383bce38389’ );

// Some Windows-1252 characters (ãƒ)
$contains = hex2bin ( ‘e383’ );
// ^ file_get_contents() produces the same data when it is saved as «ANSI» in Notepad on Windows, so this is not that unrealistic. The only reason to use hex2bin here is to mix character sets without having to use multiple files.

// A character that actually exists in our string. (ー)
$contains2 = hex2bin ( ‘e383bc’ );

echo » = Haystack: » . var_export ( $string , true ). «\r\n» ;
echo » = Needles:\r\n» ;
echo » + Windows-1252 characters\r\n» ;
echo » — Results:\r\n» ;
echo » > str_contains: » . var_export ( str_contains ( $string , $contains ), true ). «\r\n» ;
echo » > mb_str_contains: » . var_export ( mb_str_contains ( $string , $contains ), true ). «\r\n» ;
echo » + Valid UTF-8 character\r\n» ;
echo » — Results:\r\n» ;
echo » > str_contains: » . var_export ( str_contains ( $string , $contains2 ), true ). «\r\n» ;
echo » > mb_str_contains: » . var_export ( mb_str_contains ( $string , $contains2 ), true ). «\r\n» ;
echo «\r\n» ;
?>

Output:

= Haystack: ‘漢字はユニコード’
= Needles:
+ Windows-1252 characters
— Results:
> str_contains: true
> mb_str_contains: false
+ Valid UTF-8 character
— Results:
> str_contains: true
> mb_str_contains: true

It’s not completely foolproof, however. For instance, ド in Windows-1252 will match ド from the above string. So it’s still best to convert the encoding of the parameters to be the same first. But, if the character set isn’t known/can’t be detected and you have no choice but to deal with dirty data, this is probably the simplest solution.

strstr

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

Замечание:

Эта функция учитывает регистр символов. Для поиска без учета регистра используйте stristr() .

Замечание:

Если нужно лишь определить, встречается ли подстрока needle в haystack , используйте более быструю и менее ресурсоемкую функцию strpos() .

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

Если needle не является строкой, он приводится к целому и трактуется как код символа.

Если установлен в TRUE , strstr() возвращает часть строки haystack до первого вхождения needle (исключая needle).

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

Возвращает часть строки, или FALSE , если needle не найдена.

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

Версия	Описание
5.3.0	Добавлен необязательный параметр before_needle .
4.3.0	strstr() теперь бинарно безопасна.

Примеры

Пример #1 Пример использования strstr()

$email = ‘name@example.com’ ;
$domain = strstr ( $email , ‘@’ );
echo $domain ; // выводит @example.com

$user = strstr ( $email , ‘@’ , true ); // Начиная с PHP 5.3.0
echo $user ; // выводит name
?>

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

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