Função count_chars

A função count_chars conta quantas vezes os diferentes caracteres aparecem em uma string.

O primeiro parâmetro da função recebe uma string, e o segundo parâmetro opcional - um modificador, que altera o resultado da função.

Sintaxe

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

Valores do modificador

Dependendo do valor do parâmetro a função retorna o seguinte:

Valor 0 - array, cujas chaves são códigos ASCII, e os valores - o número de ocorrências do caractere correspondente.
Valor 1 - o mesmo que para 0, mas informações sobre caracteres com zero ocorrências não são incluídas no array.
Valor 2 - o mesmo que para 0, mas o array inclui informações apenas sobre caracteres com zero ocorrências.
Valor 3 - string, consistindo de caracteres que aparecem na string original pelo menos uma vez.
Valor 4 - string, consistindo de caracteres que não aparecem na string original.

Por padrão, a função se comporta como se o segundo parâmetro estivesse definido como 0.

Exemplo

Vamos contar a quantidade de caracteres em uma string, definindo o modificador para o valor 1:

<?php
	$str = 'aaabbc';
	$res = count_chars($str, 1);
	var_dump($res);
?>

Como resultado, a função retornará os códigos de todos os caracteres de 0 a 255, e entre esses códigos estarão os códigos dos nossos caracteres da string:

[
	0   => 0,
	1   => 1,
	...
	97  => 3, // 97 código do caractere 'a'
	98  => 2, // 98 código do caractere 'b'
	99  => 1, // 99 código do caractere 'c'
	...
	255 => 0,
]

Exemplo

Vamos contar a quantidade de caracteres em uma string, definindo o modificador para o valor 1:

<?php
	$str = 'aaabbc';
	$res = count_chars($str, 1);
	var_dump($res);
?>

Como resultado, a função retornará apenas os códigos dos caracteres encontrados e a quantidade desses caracteres:

[
	97 => 3, // 97 código do caractere 'a'
	98 => 2, // 98 código do caractere 'b'
	99 => 1, // 99 código do caractere 'c'
]

Veja também

a função substr_count,
que conta o número de substrings
a função count_chars,
que conta o número de caracteres
a função str_word_count,
que conta o número de palavras