count_chars

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

count_charsRetorna 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

Example #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