count_chars

(PHP 4, PHP 5)

count_chars — Retorna informações sobre os caracteres usados numa string

Descrição

mixed count_chars ( string $string [, int $mode ] )

Conta o número de ocorrências de cada byte-value (0..255) na string e retorna ela de várias maneiras.

Parâmetros

string: A string a ser examinada.
mode: O parâmetro opcional mode , o valor padrão é 0.

Valor Retornado

Dependendo do mode count_chars() pode retornar o seguinte:

0 - Um array com um byte-value como chave e a freqüência de cada byte como valor.
1 - mesmo que o 0 mas apenas byte-values com freqüência maior do que 0 são listadas.
2 - mesmo que 0 mas apenas byte-values com freqüência igual a 0 são listadas.
3 - uma string contendo todos caracteres únicos é retornada.
4 - uma string contendo todos caracteres não usados é retornada.

Exemplos

Exemplo #1 Exemplo count_chars()


<?php
$data = "Two Ts and one F.";

foreach (count_chars($data, 1) as $i => $val) {
   echo "There were $val instance(s) of \"" , chr($i) , "\" in the string.\n";
}
?>

O exemplo acima irá imprimir:

There were 4 instance(s) of " " in the string.
There were 1 instance(s) of "." in the string.
There were 1 instance(s) of "F" in the string.
There were 2 instance(s) of "T" in the string.
There were 1 instance(s) of "a" in the string.
There were 1 instance(s) of "d" in the string.
There were 1 instance(s) of "e" in the string.
There were 2 instance(s) of "n" in the string.
There were 2 instance(s) of "o" in the string.
There were 1 instance(s) of "s" in the string.
There were 1 instance(s) of "w" in the string.

Veja Também

crc32

convert_uuencode

Last updated: Fri, 14 Nov 2008

add a note User Contributed Notes
count_chars

phpC2007
04-Dec-2007 07:42


Here's a function to count number of strings in a string. It can be used as a simple utf8-enabled count_chars (but limited to a single mode)...



<?php

function utf8_count_strings($stringChar)

{

    $num = -1;

    $lenStringChar = strlen($stringChar);

    

    for ($lastPosition = 0; 

        $lastPosition !== false;

        $lastPosition = strpos($textSnippet, $stringChar, $lastPosition + $lenStringChar))

    {

        $num++;

    }

    

    return $num;

}

?>

pzb at novell dot com
28-Jul-2007 06:29


This function is great for input validation.  I frequently need to check that all characters in a string are 7-bit ASCII (and not null).  This is the fastest function I have found yet:



<?php

function is7bit($string) {

    // empty strings are 7-bit clean

    if (!strlen($string)) {

        return true;

    }

    // count_chars returns the characters in ascending octet order

    $str = count_chars($str, 3);

    // Check for null character

    if (!ord($str[0])) {

        return false;

    }

    // Check for 8-bit character

    if (ord($str[strlen($str)-1]) & 128) {

        return false;

    }

    return true;

}

?>

Patrick Palka
10-Apr-2007 08:46


A faster unique character-checking function:



<?php

function chr_unique($string) {

  return strlen(count_chars($string, 3));

}

?>

apinpratap at gmail dot com
29-Mar-2007 11:54


this code can find each characters count



<?php

$enter = 0;

$data = strtolower ($inputString);

foreach (count_chars ($data, 1) as $i => $val) 

    {

        if ($enter == 1)

        {

            $enter = 0;

            continue;

        }

        if (chr ($i) == "\n")

        {

            echo "There are $val instance(s) of \" Enter \" in the string.\n";

            $enter = 1;

        }

        else

        {

            echo "There are $val instance(s) of \"" , chr ($i) , "\" in the string.\n";

        }

    }

?>

Eric Pecoraro
27-May-2005 07:31


<?php



// Require (n) unique characters in a string

// Modification of a function below which ads some flexibility in how many unique characters are required in a given string.



$pass = '123456' ; // true

$pass = '111222' ; // false



req_unique($pass,3);



function req_unique($string,$unique=3) {

    if ( count(count_chars($string,1)) < $unique) {

        echo 'false';

    }else{

        echo 'true';

    }

}



?>

Alex Gemmell
14-Feb-2005 10:03


Use: Great for checking for unique characters in a password.



I wanted to check that my website users, when registering a user account, chose a "valid" (not-so-easily-guessed) password.



One of the many checks was that the password must have 6 unique characters.  I was tying myself in knots with all kinds of recursive array calling when I was offered this wonderful one line solution:



function check_password($password) {



   #Have 6 unique characters

   if (count(count_chars($password, 1)) < 6) return false;



   #

   # other checks returning false as necessary

   #

   #



   return true;

}



I cannot claim this wonderful line for myself - a Mr Lynch suggested this to me.  Thanks!

seb at synchrocide dot net
16-May-2004 03:08


After much trial and error trying to create a function that finds the number of unique characters in a string I same across count_chars() - my 20+ lines of useless code were wiped for this:



<?

function unichar($string) {

$two= strtolower(str_replace(' ', '', $string));

$res = count(count_chars($two, 1));

return $res;

}



/* examples :: */



echo unichar("bob"); // 2

echo unichar("Invisibility"); //8

echo unichar("The quick brown fox slyly jumped over the lazy dog"); //26



?>



I have no idea where this could be used, but it's quite fun

mlong at mlong dot org
29-Jan-2002 04:27


// Usefulness of the two functions





<?php


 $string="aaabbc";





 // You just want to count the letter a


 $acount=substr_count($string,"a");





 // You want to count both letter a and letter b


 $counts=count_chars($string,0);


 $acount=$counts[ord("a")];


 $bcount=$counts[ord("b")];


?>

maotin at hongkong dot com
31-Jan-2001 05:04


Here are some more experiments on this relatively new and extremely handy function.





<?php


$string = 'I have never seen ANYTHING like that before! My number is "4670-9394".';





foreach(count_chars($string, 1) as $chr => $hit)


echo 'The character '.chr(34).chr($chr).chr(34).' has appeared in this string '.$hit.' times.<BR>';





#The result looks like


#The character " " has appeared in this string 11 times.





echo count_chars($string,3);


#The output is '!"-.034679AGHIMNTYabefhiklmnorstuvy'





echo strlen($string).' is not the same as '.strlen(count_chars($string, 3));





#This shows that '70 is not the same as 36'


?>





As we can see above:





1)If you cares only about what is in the string, use count_chars($string, 1) and it will return an (associative?) array of what shows up only.





2) Either I misunderstood what the manul actually said, or it does not work the way it described: count_chars($strting, 3) actually returned a string of what characters are in the string, not a string of their byte-values (which is great because a string of numbers would be much harder to handle);





3)This is a short version of password checking: get the original string's length, then compare with the length of the string returned by count_chars($string,3).  





<?php


$length_of_string = strlen($string);


$num_of_chars = strlen(count_chars($string, 3));





$diff = ($length_of_string - $num_of_chars);





if ($diff)


echo 'At least one character has been used more than once.';


else


echo 'All character have been used only once.;


?>





Note that since $num_of_chars gives no information about the actual number of occurance, we cannot go any further by the same rationale and say when $diff =2 then 2 characters showed up twice; it might be 1 character showd up 3 times, we have no way to tell (a good tolerance level setter, though).  You have to get the array and check the values if you want to have more control.





4) Final trick: now we have a primitive way to count the number of words in a string! (or do we have a fuction for that already?)

add a note

crc32

convert_uuencode

Last updated: Fri, 14 Nov 2008