From 719aed0d1ccc0ab70a4af2ca4b6dd78a240517ad Mon Sep 17 00:00:00 2001
From: Mehdi Achour <didou@php.net>
Date: Mon, 20 Oct 2003 11:54:57 +0000
Subject: [PATCH] adding example (user note)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@142762 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/strings/functions/count-chars.xml | 43 ++++++++++++++++++++-
 1 file changed, 41 insertions(+), 2 deletions(-)

diff --git a/reference/strings/functions/count-chars.xml b/reference/strings/functions/count-chars.xml
index b7184c7075..0962e16149 100644
--- a/reference/strings/functions/count-chars.xml
+++ b/reference/strings/functions/count-chars.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/strings.xml, last change in rev 1.4 -->
   <refentry id="function.count-chars">
    <refnamediv>
@@ -18,7 +18,7 @@
     <para>
      Counts the number of occurrences of every byte-value (0..255) in
      <parameter>string</parameter> and returns it in various ways.
-     The optional parameter <parameter>Mode</parameter> default to
+     The optional parameter <parameter>mode</parameter> default to
      0. Depending on <parameter>mode</parameter>
      <function>count_chars</function> returns one of the following:
      <itemizedlist>
@@ -52,6 +52,45 @@
       </listitem> 
      </itemizedlist>
     </para>
+    <para>
+     <example>
+      <title><function>count_chars</function> example</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+
+$data = "Two Ts and one F.";
+
+$result = count_chars($data, 0);
+
+for ($i=0; $i < count($result); $i++) {
+   if ($result[$i] != 0)
+       echo "There were $result[$i] instance(s) of \"" , chr($i) , "\" in the string.\n";
+}
+
+?>
+]]>
+      </programlisting>
+      <para>
+       This will output :
+      </para>
+      <screen>
+<![CDATA[
+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. 
+]]>
+      </screen>
+     </example> 
+    </para>
     <simpara>
      See also <function>strpos</function> and
      <function>substr_count</function>.