Conta o número de ocorrências de uma substring

Descrição

substr_count(
    string $haystack,
    string $needle,
    int $offset = 0,
    ?int $length = null
): int

substr_count() retorna o número de vezes que a substring needle ocorre na string haystack. Note que needle faz distinção de maiúscula e minúscula.

Note:
Esta função não conta substrings sobrepostas. Veja o exemplo abaixo!

Parâmetros

haystack: A string onde será feita a busca
needle: A substring a ser procurada
offset: A posição onde deve-se iniciar a contagem. Se a posição for negativa, a contagem começa do final da string.
length: O comprimento máximo depois da posição especificada para buscar pela substring. Mostra um alerta se a posição mais o comprimento for maior que o comprimento de haystack. Um comprimento negativo conta a partir do final de haystack.

Valor Retornado

Esta função retorna um int.

Registro de Alterações

Versão	Descrição
8.0.0	`length` agora pode ser nulo.
7.1.0	Suporte a valores negativos para `offset` e `length` foi adicionado. `length` agora também pode ser `0`.

Exemplos

Example #1 Exemplo de substr_count()

<?php
$text = 'This is a test';
echo strlen($text); // 14

echo substr_count($text, 'is'); // 2

// a string é reduzida a 's is a test', então mostra 1
echo substr_count($text, 'is', 3);

// o texto é reduzido a 's i', então mostra 0
echo substr_count($text, 'is', 3, 3);

// gera um alerta porque 5+10 > 14
echo substr_count($text, 'is', 5, 10);


// mostra apenas 1, porque não conta substrings sobrepostos
$text2 = 'gcdgcdgcd';
echo substr_count($text2, 'gcdgcd');
?>

Veja Também

count_chars() - Retorna informação sobre caracteres usados em uma string
strpos() - Encontra a posição da primeira ocorrência de uma substring em uma string
substr() - Retorna parte de uma string
strstr() - Encontra a primeira ocorrência de uma string