str_contains

(PHP 8)

str_contains — Determina se uma string contém uma substring fornecida

Descrição

str_contains(string $haystack, string $needle): bool

Realiza uma busca, sensível a maiúsculas/minúsculas, indicando se needle existe em haystack.

Parâmetros

haystack: A string onde será feita a busca.
needle: A substring para ser buscada em haystack.

Valor Retornado

Retorna true se needle está em haystack, false caso contrário.

Exemplos

Exemplo #1 Usando a string vazia ''

<?php
if (str_contains('abc', '')) {
    echo "Verificar a existência de uma string vazia sempre retornará true";
}
?>

O exemplo acima produzirá:

Verificar a existência de uma string vazia sempre retornará true

Exemplo #2 Mostrando a sensibilidade a maiúsculas/minúsculas

<?php
$string = 'A raposa preguiçosa pulou a cerca';

if (str_contains($string, 'raposa')) {
    echo "A string 'raposa' foi encontrada na string\n";
}

if (str_contains($string, 'Raposa')) {
    echo 'A string "Raposa" foi encontrada na string';
} else {
    echo '"Raposa" não foi encontrada porque a letra maiúscula não corresponde';
}

?>

O exemplo acima produzirá:

A string 'raposa' foi encontrada na string
"Raposa" não foi encontrada porque a letra maiúscula não corresponde

Notas

Nota: Esta função é compatível com dados binários.

Veja Também

str_ends_with() - Verifica se uma string termina com uma substring fornecida
str_starts_with() - Verifica se uma string começa com uma substring fornecida
stripos() - Encontra a posição da primeira ocorrência de uma substring em uma string, de forma insensível a maiúsculas/minúsculas
strrpos() - Encontra a posição da última ocorrência de uma substring em uma string
strripos() - Encontra a posição da última ocorrência de uma substring em uma string, insensível a miúsculas/minúsculas
strstr() - Encontra a primeira ocorrência de uma string
strpbrk() - Procura na string por um dos caracteres de um conjunto
substr() - Retorna parte de uma string
preg_match() - Realiza uma correspondência com expressão regular