الفرق بين المراجعتين لصفحة: «PHP/count chars»

من موسوعة حسوب
< PHP
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة count_chars()‎ في PHP}}</noinclude>'
 
لا ملخص تعديل
 
(مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة count_chars()‎ في PHP}}</noinclude>
<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]]

المراجعة الحالية بتاريخ 15:36، 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()‎: حساب عدد تكرارات السلسلة الفرعية.

مصادر