(PHP 4, PHP 5, PHP 7, PHP 8)
substr_count — Conta o número de ocorrências de uma substring
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.
Nota:
Esta função não conta substrings sobrepostas. Veja o exemplo abaixo!
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
.
Esta função retorna um int.
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 . |
Exemplo #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');
?>