الفرق بين المراجعتين لصفحة: «PHP/count chars»
< PHP
هارون-بوكرش (نقاش | مساهمات) لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
تعيد الدالة | تعيد الدالة <code>count_chars()</code> معلومات عن الأحرف الموجودة بالسلسلة النصية. | ||
== الوصف == | |||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
mixed count_chars ( string $string [, int $mode = 0 ] ) | mixed count_chars ( string $string [, int $mode = 0 ] ) | ||
</syntaxhighlight>تعيد الدالة عدد التكرارات لكل قيمة بايت (byte-value) من القيمة 0 إلى 255 في سلسلة نصية بطرائق مختلفة. | </syntaxhighlight>تعيد الدالة عدد التكرارات لكل قيمة بايت (byte-value) من القيمة 0 إلى 255 في سلسلة نصية بطرائق مختلفة. | ||
== المعاملات == | |||
=== | === <code>string</code> === | ||
السلسلة النصية التي نريد فحصها. | السلسلة النصية التي نريد فحصها. | ||
=== | === <code>mode</code> === | ||
يحدد طريقة عمل الدالة count_chars(). | يحدد طريقة عمل الدالة <code>count_chars()</code>. | ||
== القيم المعادة == | |||
تختلف القيم المعادة للدالة count_chars() على حسب قيمة المعامل mode كما يلي: | تختلف القيم المعادة للدالة <code>count_chars()</code> على حسب قيمة المعامل <code>mode</code> كما يلي: | ||
* 0: تعيد الدالةُ مصفوفةَ بياناتٍ. إذ يكون مفتاح الجدول هو قيمة البايت وقيم المصفوفة هي عدد التكرارات لكل مفتاح. | * <code>0</code>: تعيد الدالةُ مصفوفةَ بياناتٍ. إذ يكون مفتاح الجدول هو قيمة البايت وقيم المصفوفة هي عدد التكرارات لكل مفتاح. | ||
* 1: نفس مبدأ عمل الدالة count_chars() عندما يكون المعامل mode يساوي 0 لكن تعيد عدد التكرارات غير المعدومة فقط. | * <code>1</code>: نفس مبدأ عمل الدالة <code>count_chars()</code> عندما يكون المعامل <code>mode</code> يساوي <code>0</code> لكن تعيد عدد التكرارات غير المعدومة فقط. | ||
* 2: نفس مبدأ عمل الدالة count_chars() عندما يكون المعامل mode يساوي 0 لكن تعيد عدد التكرارات المعدومة فقط أي تعيد كل الحروف غير الموجودة بالمعامل string. | * <code>2</code>: نفس مبدأ عمل الدالة <code>count_chars()</code> عندما يكون المعامل <code>mode</code> يساوي <code>0</code> لكن تعيد عدد التكرارات المعدومة فقط أي تعيد كل الحروف غير الموجودة بالمعامل <code>string</code>. | ||
* 3: تعيد الدالة count_chars() سلسلة نصية تحتوي على كل الأحرف غير المكررة. | * <code>3</code>: تعيد الدالة <code>count_chars()</code> سلسلة نصية تحتوي على كل الأحرف غير المكررة. | ||
* 4: تعيد الدالة count_chars() سلسلة نصية تحتوي على جميع الأحرف غير المستخدمة. | * <code>4</code>: تعيد الدالة <code>count_chars()</code> سلسلة نصية تحتوي على جميع الأحرف غير المستخدمة. | ||
== أمثلة == | |||
المثال 1: مثال بسيط عن الدالة <code>count_chars()</code><syntaxhighlight lang="php"> | |||
<syntaxhighlight lang="php"> | |||
<?php | <?php | ||
$data = "Two Ts and one F."; | $data = "Two Ts and one F."; | ||
foreach (count_chars($data, 1) as $i => $val) { | foreach (count_chars($data, 1) as $i => $val) { | ||
echo "There were $val instance(s) of \"" , chr($i) , "\" in the string.\n"; | echo "There were $val instance(s) of \"" , chr($i) , "\" in the string.\n"; | ||
} | } | ||
?> | ?> | ||
</syntaxhighlight>سيُخرِج المثال السابق الناتج الآتي:<syntaxhighlight lang="text"> | |||
</syntaxhighlight>سيُخرِج المثال السابق الناتج الآتي:<syntaxhighlight lang=" | |||
There were 4 instance(s) of " " in the string. | There were 4 instance(s) of " " in the string. | ||
There were 1 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 1 instance(s) of "F" in the string. | ||
There were 2 instance(s) of "T" 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 "a" in the string. | ||
There were 1 instance(s) of "d" 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 1 instance(s) of "e" in the string. | ||
There were 2 instance(s) of "n" 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 2 instance(s) of "o" in the string. | ||
There were 1 instance(s) of "s" in the string. | There were 1 instance(s) of "s" in the string. | ||
There were 1 instance(s) of "w" in the string. | There were 1 instance(s) of "w" in the string. | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | |||
* strpos(): إيجاد موقع أول ظهور لسلسة نصية فرعية داخل سلسلة نصية. | * <code>[[PHP/strpos|strpos()]]</code>: إيجاد موقع أول ظهور لسلسة نصية فرعية داخل سلسلة نصية. | ||
* substr_count(): حساب عدد تكرارات السلسلة الفرعية. | * <code>[[PHP/substr count|substr_count()]]</code>: حساب عدد تكرارات السلسلة الفرعية. | ||
== مصادر == | |||
* صفحة الدالة count_chars في توثيق PHP الرسمي. | * [http://php.net/manual/en/function.count-chars.php صفحة الدالة count_chars في توثيق PHP الرسمي]. | ||
مراجعة 15:35، 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(): حساب عدد تكرارات السلسلة الفرعية.