الفرق بين المراجعتين ل"PHP/str split"
< PHP
اذهب إلى التنقل
اذهب إلى البحث
(أضفت المحتوى) |
|||
| (مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | + | <noinclude>{{DISPLAYTITLE:الدالة <code>str_split()</code> في PHP}}</noinclude> | |
| − | |||
(PHP 5, PHP 7) | (PHP 5, PHP 7) | ||
| − | تُحَوِّلُ الدالة str_split() السلسلة النصية إلى مصفوفة. | + | تُحَوِّلُ الدالة <code>str_split()</code> السلسلة النصية إلى مصفوفة. |
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
array str_split ( string $string [, int $split_length = 1 ] ) | array str_split ( string $string [, int $split_length = 1 ] ) | ||
| − | </syntaxhighlight>تُحَوِّلُ الدالة str_split() السلسلة النصية إلى مصفوفة. | + | </syntaxhighlight>تُحَوِّلُ الدالة <code>str_split()</code> السلسلة النصية إلى مصفوفة. |
== المعاملات == | == المعاملات == | ||
| − | === string === | + | === <code>string</code> === |
السلسلة النصية المدخلة. | السلسلة النصية المدخلة. | ||
| − | === split_length === | + | === <code>split_length</code> === |
الحد الأقصى لطول القطعة. | الحد الأقصى لطول القطعة. | ||
| − | + | == القيم المعادة == | |
| − | إذا حُدِّدَ المعامل الاختياري | + | إذا حُدِّدَ المعامل الاختياري <code>split_length</code>، فستقسم المصفوفة المعادة إلى أجزاءٍ طولُ كلٍّ واحد منها يساوي قيمة المعامل <code>split_length</code>، وإلا فسيكون طول كل قطعة حرفًا واحدًا. |
| − | تعاد القيمة FALSE إذا كان المعامل split_length أقل من 1. إذا كان طول المعامل split_length يتجاوز طول المعامل | + | تعاد القيمة <code>FALSE</code> إذا كان المعامل <code>split_length</code> أقل من 1. إذا كان طول المعامل <code>split_length</code> يتجاوز طول المعامل <code>string</code>، فستعاد السلسلة بأكملها كعنصر المصفوفة الأول (والوحيد). |
== أمثلة == | == أمثلة == | ||
| − | المثال 1: مثال على استخدام الدالة str_split()<syntaxhighlight lang="php"> | + | المثال 1: مثال على استخدام الدالة <code>str_split()</code><syntaxhighlight lang="php"> |
<?php | <?php | ||
| − | |||
$str = "Hello Friend"; | $str = "Hello Friend"; | ||
| − | |||
$arr1 = str_split($str); | $arr1 = str_split($str); | ||
| − | |||
$arr2 = str_split($str, 3); | $arr2 = str_split($str, 3); | ||
| − | |||
print_r($arr1); | print_r($arr1); | ||
| − | |||
print_r($arr2); | print_r($arr2); | ||
| − | |||
?> | ?> | ||
| − | </syntaxhighlight>ناتج المثال السابق:<syntaxhighlight lang=" | + | </syntaxhighlight>ناتج المثال السابق:<syntaxhighlight lang="text"> |
Array | Array | ||
| − | |||
( | ( | ||
| − | |||
[0] => H | [0] => H | ||
| − | |||
[1] => e | [1] => e | ||
| − | |||
[2] => l | [2] => l | ||
| − | |||
[3] => l | [3] => l | ||
| − | |||
[4] => o | [4] => o | ||
| − | |||
[5] => | [5] => | ||
| − | |||
[6] => F | [6] => F | ||
| − | |||
[7] => r | [7] => r | ||
| − | |||
[8] => i | [8] => i | ||
| − | |||
[9] => e | [9] => e | ||
| − | |||
[10] => n | [10] => n | ||
| − | |||
[11] => d | [11] => d | ||
| − | |||
) | ) | ||
Array | Array | ||
| سطر 75: | سطر 54: | ||
[3] => end | [3] => end | ||
) | ) | ||
| − | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== ملاحظات == | == ملاحظات == | ||
| − | ملاحظة: ستقسم الدالة str_split() السلسلةَ النصيةَ إلى عدد من البايت بدلاً من الأحرف عند التعامل مع سلسلة تُرمَّز فيها المحارف بأكثر من بايت. | + | ملاحظة: ستقسم الدالة <code>str_split()</code> السلسلةَ النصيةَ إلى عدد من البايت بدلاً من الأحرف عند التعامل مع سلسلة تُرمَّز فيها المحارف بأكثر من بايت. |
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * الدالة chunk_split(): تقسيم سلسلة نصية إلى قطع أصغر. | + | * الدالة <code>[[PHP/chunk split|chunk_split()]]</code>: تقسيم سلسلة نصية إلى قطع أصغر. |
| − | * الدالة preg_split(): تقسيم السلسلة النصية بواسطة التعابير النمطية. | + | * الدالة <code>[[PHP/preg split|preg_split()]]</code>: تقسيم السلسلة النصية بواسطة التعابير النمطية. |
| − | * الدالة explode(): تقسيم سلسلة نصية بواسطة سلسلة نصية أخرى. | + | * الدالة <code>[[PHP/explode|explode()]]</code>: تقسيم سلسلة نصية بواسطة سلسلة نصية أخرى. |
| − | * الدالة count_chars(): إعادة معلومات حول الأحرف المستخدمة في سلسلة نصية. | + | * الدالة <code>[[PHP/count chars|count_chars()]]</code>: إعادة معلومات حول الأحرف المستخدمة في سلسلة نصية. |
| − | * الدالة str_word_count(): إعادة معلومات حول الكلمات المستخدمة في سلسلة نصية. | + | * الدالة <code>[[PHP/str word count|str_word_count()]]</code>: إعادة معلومات حول الكلمات المستخدمة في سلسلة نصية. |
| − | * حلقة for التكرارية. | + | * [[PHP/for|حلقة for التكرارية]]. |
== مصادر == | == مصادر == | ||
* [http://php.net/manual/en/function.str-split.php صفحة الدالة str_split في توثيق PHP الرسمي.] | * [http://php.net/manual/en/function.str-split.php صفحة الدالة str_split في توثيق PHP الرسمي.] | ||
| + | [[تصنيف:PHP]] | ||
| + | [[تصنيف:PHP Function]] | ||
| + | [[تصنيف:PHP String]] | ||
المراجعة الحالية بتاريخ 12:57، 9 أبريل 2018
(PHP 5, PHP 7)
تُحَوِّلُ الدالة str_split() السلسلة النصية إلى مصفوفة.
الوصف
array str_split ( string $string [, int $split_length = 1 ] )
تُحَوِّلُ الدالة str_split() السلسلة النصية إلى مصفوفة.
المعاملات
string
السلسلة النصية المدخلة.
split_length
الحد الأقصى لطول القطعة.
القيم المعادة
إذا حُدِّدَ المعامل الاختياري split_length، فستقسم المصفوفة المعادة إلى أجزاءٍ طولُ كلٍّ واحد منها يساوي قيمة المعامل split_length، وإلا فسيكون طول كل قطعة حرفًا واحدًا.
تعاد القيمة FALSE إذا كان المعامل split_length أقل من 1. إذا كان طول المعامل split_length يتجاوز طول المعامل string، فستعاد السلسلة بأكملها كعنصر المصفوفة الأول (والوحيد).
أمثلة
المثال 1: مثال على استخدام الدالة str_split()
<?php
$str = "Hello Friend";
$arr1 = str_split($str);
$arr2 = str_split($str, 3);
print_r($arr1);
print_r($arr2);
?>
ناتج المثال السابق:
Array
(
[0] => H
[1] => e
[2] => l
[3] => l
[4] => o
[5] =>
[6] => F
[7] => r
[8] => i
[9] => e
[10] => n
[11] => d
)
Array
(
[0] => Hel
[1] => lo
[2] => Fri
[3] => end
)
ملاحظات
ملاحظة: ستقسم الدالة str_split() السلسلةَ النصيةَ إلى عدد من البايت بدلاً من الأحرف عند التعامل مع سلسلة تُرمَّز فيها المحارف بأكثر من بايت.
انظر أيضًا
- الدالة
chunk_split(): تقسيم سلسلة نصية إلى قطع أصغر. - الدالة
preg_split(): تقسيم السلسلة النصية بواسطة التعابير النمطية. - الدالة
explode(): تقسيم سلسلة نصية بواسطة سلسلة نصية أخرى. - الدالة
count_chars(): إعادة معلومات حول الأحرف المستخدمة في سلسلة نصية. - الدالة
str_word_count(): إعادة معلومات حول الكلمات المستخدمة في سلسلة نصية. - حلقة for التكرارية.