Determina se uma string contém uma substring fornecida

# str_contains

(PHP 8)

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

### Descrição

function 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 maiú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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open