Resumo : neste tutorial, você aprenderá como usar a str_contains()
função PHP para verificar se uma string contém uma substring.
Introdução à função PHP str_contains()
A função PHP str_contains()
verifica se uma string contém uma substring. Aqui está a sintaxe da str_contains()
função:
str_contains ( string $haystack , string $needle ) : bool
Linguagem de código: PHP ( php )
A str_contains()
função possui os seguintes parâmetros:
$haystack
é a string a ser verificada.$needle
é a substring a ser pesquisada na string de entrada$haystack
.
A str_contains()
função retorna true
se $needle
estiver no $haystack
, false
caso contrário.
Ao pesquisar por $needle
no $haystack
, a str_contains()
função usa uma pesquisa que diferencia maiúsculas de minúsculas .
Observe que str_contains()
a função está disponível desde o PHP 8.0.0. Se você usar uma versão anterior do PHP, poderá preencher a str_contains()
função assim:
<?php
if (!function_exists('str_contains')) {
function str_contains( $haystack, $needle)
{
return $needle !== '' && mb_strpos($haystack, $needle) !== false;
}
Linguagem de código: PHP ( php )
Exemplos de funções PHP str_contains()
O exemplo a seguir usa a str_contains()
função para verificar se a string 'PHP'
está na string 'PHP string functions'
:
<?php
$haystack = 'PHP is cool.';
$needle = 'PHP';
$result = str_contains($haystack, $needle) ? 'is' : 'is not';
echo "The string {$needle} {$result} in the sentence.";
Linguagem de código: PHP ( php )
Saída:
The string PHP is in the sentence
Linguagem de código: PHP ( php )
Conforme mencionado anteriormente, a str_contains()
função usa a pesquisa com distinção entre maiúsculas e minúsculas para verificar se uma substring está em uma string. Por exemplo:
<?php
$haystack = 'PHP is cool.';
$needle = 'Cool';
$result = str_contains($haystack, $needle) ? 'is' : 'is not';
echo "The string {$needle} {$result} in the sentence.";
Linguagem de código: PHP ( php )
Saída:
The string Cool is not in the sentence.
Linguagem de código: PHP ( php )
Resumo
- Use a função PHP
str_contains()
para realizar uma pesquisa com distinção entre maiúsculas e minúsculas para verificar se uma string está em outra string.