array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.substr-count.php', 1 => 'substr_count', 2 => 'Conta o número de ocorrências de uma substring', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funções de String', ), 'prev' => array ( 0 => 'function.substr-compare.php', 1 => 'substr_compare', ), 'next' => array ( 0 => 'function.substr-replace.php', 1 => 'substr_replace', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/strings/functions/substr-count.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

substr_count

(PHP 4, PHP 5, PHP 7, PHP 8)

substr_count — 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.

Nota:

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

Exemplo #1 Exemplo de substr_count()

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

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

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

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

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

// lança uma exceção porque 5+10 > 14
echo substr_count($text, 'is', 5, 10), PHP_EOL;
?>

Veja Também