الدالة str_word_count() في PHP
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
تعيد الدالة str_word_count() معلومات حول الكلمات المستخدمة في سلسلة نصية.
الوصف
mixed str_word_count ( string $string [, int $format = 0 [, string $charlist ]] )
تحسب الدالة str_word_count() عدد الكلمات داخل المعامل string. إذا لم يُحَدَّد المعامل الاختياري format، فستكون القيمة المعادة عددًا صحيحًا يمثل عدد الكلمات التي عُثِرَ عليها. في حالة تحديد المعامل format، ستكون القيمة المعادة مصفوفة، يعتمد محتواها على المعامل format. القيمة الممكنة للمعامل format والقيم الناتجة مذكورة أدناه.
لغرض الدالة str_word_count()، تُعَرَّف «الكلمة» بأنها سلسلة نصية تعتمد على الإعدادات المحلية، تحتوي على أحرف هجائية والتي قد تحتوي أيضًا على الحرفين "" و " - " (لكنها لا تستطيع البدء بها).
المعاملات
string
السلسلة النصية.
format
تحديد القيم المعادة لهذه الدالة. القيم الحالية المدعمة هي:
0: إعادة عدد الكلمات التي عُثِرَ عليها.1: إعادة مصفوفة تحتوي على جميع الكلمات الموجودة داخل المعاملstring.2: إعادة مصفوفة ارتباطية، إذ يكون المفتاح هو الموضع الرقمي للكلمة داخل المعاملstringوالقيمة هي الكلمة الفعلية نفسها.
charlist
قائمة الأحرف الإضافية التي ستعدّها الدالة «كلماتٍ».
القيم المعادة
تعيد الدالة str_word_count() مصفوفة أو عددًا صحيحًا، وفقًا للمعامل format المختار.
سجل التغييرات
| الإصدار | الوصف |
|---|---|
| 5.1.0 | أضيف المعامل charlist.
|
أمثلة
المثال 1: مثال على الدالة str_word_count()
<?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);
?>
ناتج المثال السابق
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
انظر أيضًا
- الدالة
explode(): تقسيم سلسلة نصية بواسطة سلسلة نصية أخرى. - الدالة
preg_split(): تقسيم السلسلة عن طريق تعبير نمطي. - الدالة
split(): تقسيم السلسلة إلى مصفوفة باستخدام التعابير النمطية. - الدالة
count_chars(): إعادة معلومات حول الأحرف المستخدمة في سلسلة نصية. - الدالة
substr_count(): حساب عدد حالات وقوع سلسلة نصية فرعية.