عرض مصدر PHP/count chars

<noinclude>{{DISPLAYTITLE:الدالة <code>count_chars()‎</code> في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

تعيد الدالة ‎<code>count_chars()</code>‎ معلومات عن الأحرف الموجودة بالسلسلة النصية.

== الوصف ==
<syntaxhighlight lang="php">
mixed count_chars ( string $string [, int $mode = 0 ] )
</syntaxhighlight>تعيد الدالة عدد التكرارات لكل قيمة بايت (byte-value) من القيمة 0 إلى 255 في سلسلة نصية بطرائق مختلفة.

== المعاملات ==

=== <code>string</code> ===
السلسلة النصية التي نريد فحصها.

=== <code>mode</code> ===
يحدد طريقة عمل الدالة <code>count_chars()‎</code>.

== القيم المعادة ==
تختلف القيم المعادة للدالة <code>count_chars()‎</code> على حسب قيمة المعامل <code>mode</code> كما يلي:
* <code>0</code>: تعيد الدالةُ مصفوفةَ بياناتٍ. إذ يكون مفتاح الجدول هو قيمة البايت وقيم المصفوفة هي عدد التكرارات لكل مفتاح.
* <code>1</code>: نفس مبدأ عمل الدالة <code>count_chars()‎</code> عندما يكون المعامل <code>mode</code> يساوي <code>0</code> لكن تعيد عدد التكرارات غير المعدومة فقط.
* <code>2</code>: نفس مبدأ عمل الدالة <code>count_chars()‎</code> عندما يكون المعامل <code>mode</code> يساوي <code>0</code> لكن تعيد عدد التكرارات المعدومة فقط أي تعيد كل الحروف غير الموجودة بالمعامل <code>string</code>.
* <code>3</code>: تعيد الدالة <code>count_chars()‎</code> سلسلة نصية تحتوي على كل الأحرف غير المكررة.
* <code>4</code>: تعيد الدالة <code>count_chars()‎</code> سلسلة نصية تحتوي على جميع الأحرف غير المستخدمة.

== أمثلة ==
المثال 1: مثال بسيط عن الدالة <code>count_chars()‎</code><syntaxhighlight lang="php">
<?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";
}
?>

</syntaxhighlight>سيُخرِج المثال السابق الناتج الآتي:<syntaxhighlight lang="text">
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.
</syntaxhighlight>

== انظر أيضًا ==
* <code>[[PHP/strpos|strpos()‎]]</code>: إيجاد موقع أول ظهور لسلسة نصية فرعية داخل سلسلة نصية.
* <code>[[PHP/substr count|substr_count()‎]]</code>: حساب عدد تكرارات السلسلة الفرعية.

== مصادر ==
* [http://php.net/manual/en/function.count-chars.php صفحة الدالة count_chars‎ في توثيق PHP الرسمي].
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP String]]