الفرق بين المراجعتين لصفحة: «PHP/count chars»
< PHP
هارون-بوكرش (نقاش | مساهمات) أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة count_chars() في PHP}}</noinclude>' |
هارون-بوكرش (نقاش | مساهمات) لا ملخص تعديل |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة count_chars() في PHP}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة count_chars() في PHP}}</noinclude> | ||
(PHP 4, PHP 5, PHP 7) | |||
تعيد الدالة count_chars() معلومات عن الأحرف الموجودة بالسلسلة النصية. | |||
=== الوصف === | |||
<syntaxhighlight lang="php"> | |||
mixed count_chars ( string $string [, int $mode = 0 ] ) | |||
</syntaxhighlight>تعيد الدالة عدد التكرارات لكل قيمة بايت (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() ==== | |||
<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="php"> | |||
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> | |||
=== انظر أيضًا === | |||
* strpos(): إيجاد موقع أول ظهور لسلسة نصية فرعية داخل سلسلة نصية. | |||
* substr_count(): حساب عدد تكرارات السلسلة الفرعية. | |||
=== مصادر === | |||
* صفحة الدالة count_chars في توثيق PHP الرسمي. |
مراجعة 13:03، 5 أبريل 2018
(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 الرسمي.