الدالة count_chars()‎ في PHP

(PHP 4, PHP 5, PHP 7)

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

الوصف

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

تعيد الدالة عدد التكرارات لكل قيمة بايت (byte-value) من القيمة 0 إلى 255 في سلسلة نصية بطرائق مختلفة.

المعاملات

string

السلسلة النصية التي نريد فحصها.

mode

يحدد طريقة عمل الدالة count_chars()‎.

القيم المعادة

تختلف القيم المعادة للدالة count_chars()‎ على حسب قيمة المعامل mode كما يلي:

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

أمثلة

المثال 1: مثال بسيط عن الدالة 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";

}

?>

سيُخرِج المثال السابق الناتج الآتي:

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.

انظر أيضًا

• strpos()‎: إيجاد موقع أول ظهور لسلسة نصية فرعية داخل سلسلة نصية.
• substr_count()‎: حساب عدد تكرارات السلسلة الفرعية.

مصادر

• صفحة الدالة count_chars‎ في توثيق PHP الرسمي.