count_chars

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

count_chars — Retorna informação sobre caracteres usados em uma string

Descrição

count_chars(string $string, int $mode = 0): array|string

Conta o número de ocorrências de cada valor de byte (0..255) em string e retorna de diversas formas.

Parâmetros

string: A string examinada.
mode: Veja em valores de retorno.

Valor Retornado

Dependendo do parâmetro mode count_chars() retorna um dos valores a seguir:

0 - um array com valores de byte como chaves e a frequência de cada byte como valor.
1 - o mesmo que 0 mas apenas valores de byte com uma frequência maior que zero são listados.
2 - o mesmo que 0 mas apenas valores de byte com uma frequência igual a zero são listados.
3 - uma string contendo todos os caracteres únicos.
4 - uma string contendo todos os caracteres não utilizados.

Registro de Alterações

Versão	Descrição
8.0.0	Antes desta versão, a função retornava `false` em caso de falha.

Exemplos

Exemplo #1 Exemplo de count_chars()

<?php
$data = "Dois Ps e um H.";

foreach (count_chars($data, 1) as $i => $val) {
   echo "Há $val instância(s) de \"" , chr($i) , "\" na string.\n";
}
?>

O exemplo acima produzirá:

Há 4 instância(s) de " " na string.
Há 1 instância(s) de "." na string.
Há 1 instância(s) de "D" na string.
Há 1 instância(s) de "H" na string.
Há 1 instância(s) de "P" na string.
Há 1 instância(s) de "e" na string.
Há 1 instância(s) de "i" na string.
Há 1 instância(s) de "m" na string.
Há 1 instância(s) de "o" na string.
Há 2 instância(s) de "s" na string.
Há 1 instância(s) de "u" na string.

Veja Também

strpos() - Encontra a posição da primeira ocorrência de uma substring em uma string
substr_count() - Conta o número de ocorrências de uma substring