عرض مصدر PHP/str word count

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

تعيد الدالة <code>str_word_count()‎</code> معلومات حول الكلمات المستخدمة في سلسلة نصية.

== الوصف ==
<syntaxhighlight lang="php">
mixed str_word_count ( string $string [, int $format = 0 [, string $charlist ]] )
</syntaxhighlight>تحسب الدالة <code>str_word_count()‎</code> عدد الكلمات داخل المعامل <code>string</code>. إذا لم يُحَدَّد المعامل الاختياري <code>format</code>، فستكون القيمة المعادة عددًا صحيحًا يمثل عدد الكلمات التي عُثِرَ عليها. في حالة تحديد المعامل <code>format</code>، ستكون القيمة المعادة مصفوفة، يعتمد محتواها على المعامل <code>format</code>. القيمة الممكنة للمعامل <code>format</code> والقيم الناتجة مذكورة أدناه.

لغرض الدالة <code>str_word_count()‎</code>، تُعَرَّف «الكلمة» بأنها سلسلة نصية تعتمد على الإعدادات المحلية، تحتوي على أحرف هجائية والتي قد تحتوي أيضًا على الحرفين <code>""</code> و <code>" - "</code> (لكنها لا تستطيع البدء بها).

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

=== <code>string</code> ===
السلسلة النصية.

=== <code>format</code> ===
تحديد القيم المعادة لهذه الدالة. القيم الحالية المدعمة هي:
* <code>0</code>: إعادة عدد الكلمات التي عُثِرَ عليها.
* <code>1</code>: إعادة مصفوفة تحتوي على جميع الكلمات الموجودة داخل المعامل <code>string</code>.
* <code>2</code>: إعادة مصفوفة ارتباطية، إذ يكون المفتاح هو الموضع الرقمي للكلمة داخل المعامل <code>string</code> والقيمة هي الكلمة الفعلية نفسها.

=== <code>charlist</code> ===
قائمة الأحرف الإضافية التي ستعدّها الدالة «كلماتٍ».

== القيم المعادة ==
تعيد الدالة <code>str_word_count()‎</code> مصفوفة أو عددًا صحيحًا، وفقًا للمعامل <code>format</code> المختار.

== سجل التغييرات ==
{| class="wikitable"
!الإصدار
!الوصف
|-
|5.1.0
|أضيف المعامل <code>charlist</code>.
|}

== أمثلة ==
المثال 1: مثال على الدالة <code>str_word_count()‎</code><syntaxhighlight lang="php">
<?php
$str = "Hello fri3nd, you're
      looking          good today!";
print_r(str_word_count($str, 1));
print_r(str_word_count($str, 2));
print_r(str_word_count($str, 1, 'àáãç3'));
echo str_word_count($str);
?>
</syntaxhighlight>ناتج المثال السابق<syntaxhighlight lang="text">
Array
(
   [0] => Hello
   [1] => fri
   [2] => nd
   [3] => you're
   [4] => looking
   [5] => good
   [6] => today
)
Array
(
   [0] => Hello
   [6] => fri
   [10] => nd
   [14] => you're
   [29] => looking
   [46] => good
   [51] => today
)
Array
(
   [0] => Hello
   [1] => fri3nd
   [2] => you're
   [3] => looking
   [4] => good
   [5] => today
)
7
</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>[[PHP/explode|explode()‎]]</code>: تقسيم سلسلة نصية بواسطة سلسلة نصية أخرى.
* الدالة <code>[[PHP/preg split|preg_split()‎]]</code>: تقسيم السلسلة عن طريق تعبير نمطي.
* الدالة <code>[[PHP/split|split()‎]]</code>: تقسيم السلسلة إلى مصفوفة باستخدام التعابير النمطية.
* الدالة <code>[[PHP/count chars|count_chars()‎]]</code>: إعادة معلومات حول الأحرف المستخدمة في سلسلة نصية.
* الدالة <code>[[PHP/substr count|substr_count()‎]]</code>: حساب عدد حالات وقوع سلسلة نصية فرعية.

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