الفرق بين المراجعتين لصفحة: «PHP/str word count»
< PHP
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
(PHP 4 >= 4.3.0, PHP 5, PHP 7) | (PHP 4 >= 4.3.0, PHP 5, PHP 7) | ||
تعيد الدالة str_word_count() معلومات حول الكلمات المستخدمة في سلسلة نصية. | تعيد الدالة <code>str_word_count()</code> معلومات حول الكلمات المستخدمة في سلسلة نصية. | ||
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
mixed str_word_count ( string $string [, int $format = 0 [, string $charlist ]] ) | mixed str_word_count ( string $string [, int $format = 0 [, string $charlist ]] ) | ||
</syntaxhighlight>تحسب الدالة str_word_count() عدد الكلمات داخل المعامل string. إذا لم يُحَدَّد المعامل الاختياري | </syntaxhighlight>تحسب الدالة <code>str_word_count()</code> عدد الكلمات داخل المعامل <code>string</code>. إذا لم يُحَدَّد المعامل الاختياري <code>format</code>، فستكون القيمة المعادة عددًا صحيحًا يمثل عدد الكلمات التي عُثِرَ عليها. في حالة تحديد المعامل <code>format</code>، ستكون القيمة المعادة مصفوفة، يعتمد محتواها على المعامل <code>format</code>. القيمة الممكنة للمعامل <code>format</code> والقيم الناتجة مذكورة أدناه. | ||
لغرض الدالة str_word_count() | لغرض الدالة <code>str_word_count()</code>، تُعَرَّف «الكلمة» بأنها سلسلة نصية تعتمد على الإعدادات المحلية، تحتوي على أحرف هجائية والتي قد تحتوي أيضًا على الحرفين <code>""</code> و <code>" - "</code> (لكنها لا تستطيع البدء بها). | ||
== المعاملات == | == المعاملات == | ||
=== string === | === <code>string</code> === | ||
السلسلة النصية. | السلسلة النصية. | ||
=== format === | === <code>format</code> === | ||
تحديد القيم المعادة لهذه الدالة. القيم الحالية المدعمة هي: | تحديد القيم المعادة لهذه الدالة. القيم الحالية المدعمة هي: | ||
* 0: إعادة عدد الكلمات التي عُثِرَ عليها. | * <code>0</code>: إعادة عدد الكلمات التي عُثِرَ عليها. | ||
* 1: إعادة مصفوفة تحتوي على جميع الكلمات الموجودة داخل المعامل string. | * <code>1</code>: إعادة مصفوفة تحتوي على جميع الكلمات الموجودة داخل المعامل <code>string</code>. | ||
* 2: إعادة مصفوفة ارتباطية، إذ يكون المفتاح هو الموضع الرقمي للكلمة داخل المعامل string والقيمة هي الكلمة الفعلية نفسها. | * <code>2</code>: إعادة مصفوفة ارتباطية، إذ يكون المفتاح هو الموضع الرقمي للكلمة داخل المعامل <code>string</code> والقيمة هي الكلمة الفعلية نفسها. | ||
=== charlist === | === <code>charlist</code> === | ||
قائمة الأحرف الإضافية التي ستعدّها الدالة «كلماتٍ». | قائمة الأحرف الإضافية التي ستعدّها الدالة «كلماتٍ». | ||
== القيم المعادة == | == القيم المعادة == | ||
تعيد الدالة str_word_count() مصفوفة أو عددًا صحيحًا، وفقًا للمعامل format المختار. | تعيد الدالة <code>str_word_count()</code> مصفوفة أو عددًا صحيحًا، وفقًا للمعامل <code>format</code> المختار. | ||
== | == سجل التغييرات == | ||
{| class="wikitable" | {| class="wikitable" | ||
!الإصدار | |||
!الوصف | |||
|- | |- | ||
|5.1.0 | |5.1.0 | ||
|أضيف المعامل charlist. | |أضيف المعامل <code>charlist</code>. | ||
|} | |} | ||
== أمثلة == | == أمثلة == | ||
المثال 1: مثال على الدالة str_word_count()<syntaxhighlight lang="php"> | المثال 1: مثال على الدالة <code>str_word_count()</code><syntaxhighlight lang="php"> | ||
<?php | <?php | ||
$str = "Hello fri3nd, you're | $str = "Hello fri3nd, you're | ||
| سطر 47: | سطر 47: | ||
echo str_word_count($str); | echo str_word_count($str); | ||
?> | ?> | ||
</syntaxhighlight>ناتج المثال السابق<syntaxhighlight lang=" | </syntaxhighlight>ناتج المثال السابق<syntaxhighlight lang="text"> | ||
Array | Array | ||
( | ( | ||
| سطر 81: | سطر 81: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة explode(): تقسيم سلسلة نصية بواسطة سلسلة نصية أخرى. | * الدالة <code>[[PHP/explode|explode()]]</code>: تقسيم سلسلة نصية بواسطة سلسلة نصية أخرى. | ||
* الدالة preg_split(): تقسيم السلسلة عن طريق تعبير نمطي. | * الدالة <code>[[PHP/preg split|preg_split()]]</code>: تقسيم السلسلة عن طريق تعبير نمطي. | ||
* الدالة split(): تقسيم السلسلة إلى مصفوفة باستخدام التعابير النمطية. | * الدالة <code>[[PHP/split|split()]]</code>: تقسيم السلسلة إلى مصفوفة باستخدام التعابير النمطية. | ||
* الدالة count_chars(): إعادة معلومات حول الأحرف المستخدمة في سلسلة نصية. | * الدالة <code>[[PHP/count chars|count_chars()]]</code>: إعادة معلومات حول الأحرف المستخدمة في سلسلة نصية. | ||
* الدالة substr_count(): حساب عدد حالات وقوع سلسلة نصية فرعية. | * الدالة <code>[[PHP/substr count|substr_count()]]</code>: حساب عدد حالات وقوع سلسلة نصية فرعية. | ||
== مصادر == | == مصادر == | ||
* [http://php.net/manual/en/function.str-word-count.php صفحة | * [http://php.net/manual/en/function.str-word-count.php صفحة الدالة str_word_count في توثيق PHP الرسمي.] | ||
[[تصنيف:PHP]] | [[تصنيف:PHP]] | ||
[[تصنيف:PHP Function]] | [[تصنيف:PHP Function]] | ||
[[تصنيف:PHP String]] | [[تصنيف:PHP String]] | ||
المراجعة الحالية بتاريخ 12:59، 9 أبريل 2018
(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(): حساب عدد حالات وقوع سلسلة نصية فرعية.