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 case-sensitive 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     "Verificando a existência de uma string vazia sempre retornará true";
    }
    ?>

    O exemplo acima produzirá:

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

    Exemplo #2 Mostrando o case-sensitivity

    <?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 o case não corresponde';
    }

    ?>

    O exemplo acima produzirá:

    A string 'raposa' foi encontrada na string "Raposa" não foi encontrada porque o case 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() - Find the position of the first occurrence of a case-insensitive substring in a string
    • strrpos() - Find the position of the last occurrence of a substring in a string
    • strripos() - Find the position of the last occurrence of a case-insensitive substring in a string
    • strstr() - Find the first occurrence of a string
    • strpbrk() - Procura na string por um dos caracteres de um conjunto
    • substr() - Retorna parte de uma string
    • preg_match() - Perform a regular expression match
    To Top